Outline MCP server
Connect an agent to your Outline wiki to search, read, write, and organize team documents.
Outline MCP is a community server that connects an AI agent to an Outline knowledge base — the open-source team wiki — through Outline's API. It is built for grounding work in what your team has already documented: the agent can search documents, walk collection structure, resolve a document by title, read and export content, and follow backlinks, then create, update, move, archive, restore, and delete documents as knowledge changes. Collection management, threaded comments, and an ask-AI tool that answers questions over your docs round out the read side, while batch tools let an agent create, update, move, archive, or delete many documents in one call.
It runs locally over stdio with uvx and authenticates with an Outline API key, pointing at Outline Cloud or a self-hosted instance via OUTLINE_API_URL. Outline also ships an official remote MCP server over Streamable HTTP at https://<your-subdomain>.getoutline.com/mcp with OAuth, which you can prefer when you want per-user browser authorization instead of a shared key.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Available tools
| Tool | Description |
|---|---|
| search_documents | Searches documents by keyword across the workspace. |
| list_collections | Lists the collections in the workspace. |
| get_collection_structure | Returns the document hierarchy within a collection. |
| get_document_id_from_title | Resolves a document title to its ID. |
| read_document | Reads the content of a document. |
| export_document | Exports a document, for example as Markdown. |
| create_document | Creates a new document. |
| update_document | Updates an existing document's content or metadata. |
| move_document | Moves a document to a different collection or parent. |
| archive_document | Archives a document. |
| unarchive_document | Restores a document from the archive. |
| delete_document | Sends a document to the trash. |
| restore_document | Restores a document from the trash. |
| list_archived_documents | Lists the archived documents. |
| list_trash | Lists the documents currently in the trash. |
| add_comment | Adds a comment to a document. |
| list_document_comments | Lists the comments on a document. |
| get_comment | Retrieves a single comment. |
| get_document_backlinks | Lists documents that link to a given document. |
| create_collection | Creates a new collection. |
| update_collection | Updates a collection's properties. |
| delete_collection | Deletes a collection. |
| export_collection | Exports an entire collection. |
| export_all_collections | Exports all collections in the workspace. |
| batch_create_documents | Creates multiple documents in one call. |
| batch_update_documents | Updates multiple documents in one call. |
| batch_move_documents | Moves multiple documents in one call. |
| batch_archive_documents | Archives multiple documents in one call. |
| batch_delete_documents | Deletes multiple documents in one call. |
| ask_ai_about_documents | Asks a natural-language question answered over your Outline documents. |
Required configuration
- OUTLINE_API_KEYRequired
An Outline API key generated in your Outline settings.
- OUTLINE_API_URLOptional
API base URL; defaults to https://app.getoutline.com/api. Set for self-hosted instances.
What you can do with it
Ground answers in team docs
An agent searches the wiki and returns sourced answers from existing documents instead of guessing or re-explaining a project.
Keep the wiki current
As decisions land, the agent creates or updates the right documents and files them into the correct collection automatically.
FAQ
- Is it free?
- Yes. This community server is open source under the MIT license and free to run; it works within your Outline plan and the Outline API's limits.
- Does it support remote/OAuth?
- This community build is a local stdio server authenticated with an API key. Outline also offers an official remote MCP server over Streamable HTTP at https://<your-subdomain>.getoutline.com/mcp with OAuth.