Vortiago/mcp-outline v1.9.0

Release v1.9.0

on GitHub

📦 Installation

PyPI Package:

pip install mcp-outline==1.9.0

Docker Image:

docker pull ghcr.io/Vortiago/mcp-outline:1.9.0

✨ Highlights

Token-efficient large-document workflows (#105)

• read_document pagination via offset/limit; new get_document_toc, read_document_section, and search_document_content (grep-style in-document search) for navigating big documents without loading them whole
• New edit_document: batched old_string/new_string replacements applied server-side, with save=False staging for large rewrites (one API write total)
• In-memory document cache with a short 30-second default TTL to absorb same-task read bursts (OUTLINE_CACHE_TTL, set 0 to disable); staged edits are never silently lost and all write tools invalidate the cache
• MCP server instructions guide LLM tool selection (read-only aware); typed Pydantic schemas for batch tools
• Claude Code plugin: new outline skill (Outline conventions: mermaidjs fences, structure, editing workflows) and an updated outline-explorer agent that uses TOC/section/search reading

Search status filter (#117, thanks @tvarsis)

• search_documents now accepts status_filter (draft/archived/published); defaults to published only

Document icons (#102, thanks @TaBuPeH)

• create_document and update_document accept an icon parameter

Infrastructure: e2e test stack upgraded to Outline 1.8.1

⚠️ Upgrade notes

• Document reads are now cached for up to 30 seconds by default. Writes through this server invalidate the cache (read-after-own-write is always fresh), but edits made directly in the Outline web UI can be served stale for up to 30s. Set OUTLINE_CACHE_TTL=0 to restore 1.8.0 always-fresh behavior.
• batch_update_documents/batch_create_documents now validate items up front: a malformed item (e.g. missing id) rejects the whole call with a clear validation error instead of processing the valid items and soft-failing the bad one.

What's Changed

• ci: bump anthropics/claude-code-action from 1.0.70 to 1.0.76 by @dependabot[bot] in #95
• ci: bump astral-sh/setup-uv from 7.4.0 to 7.6.0 by @dependabot[bot] in #94
• ci: bump anthropics/claude-code-action from 1.0.76 to 1.0.82 by @dependabot[bot] in #100
• ci: bump astral-sh/setup-uv from 7.6.0 to 8.0.0 by @dependabot[bot] in #99
• ci: bump mikepenz/action-junit-report from 6.3.1 to 6.4.0 by @dependabot[bot] in #98
• chore(deps): bump cryptography from 46.0.5 to 46.0.6 in the uv group across 1 directory by @dependabot[bot] in #97
• feat: add icon parameter to create_document and update_document by @TaBuPeH in #102
• ci: bump anthropics/claude-code-action from 1.0.82 to 1.0.89 by @dependabot[bot] in #103
• ci: bump docker/login-action from 4.0.0 to 4.1.0 by @dependabot[bot] in #104
• docs: add notice about official Outline MCP server by @Vortiago in #114
• added support for statusFIlter by @tvarsis in #117
• ci: bump actions/upload-artifact from 7.0.0 to 7.0.1 by @dependabot[bot] in #108
• ci: bump pypa/gh-action-pypi-publish from 1.13.0 to 1.14.0 by @dependabot[bot] in #110
• ci: bump docker/build-push-action from 7.0.0 to 7.1.0 by @dependabot[bot] in #111
• ci: bump astral-sh/setup-uv from 8.0.0 to 8.1.0 by @dependabot[bot] in #112
• ci: bump anthropics/claude-code-action from 1.0.89 to 1.0.101 by @dependabot[bot] in #113
• chore(deps): bump cryptography from 46.0.6 to 46.0.7 in the uv group across 1 directory by @dependabot[bot] in #106
• chore(deps): bump the uv group across 1 directory with 4 updates by @dependabot[bot] in #118
• feat: add paginated reading, string-match editing, document cache, an… by @Vortiago in #105

New Contributors

• @TaBuPeH made their first contribution in #102
• @tvarsis made their first contribution in #117

Full Changelog: v1.8.0...v1.9.0