Outline MCP server

CommunityVortiago150Config last verified Jun 1, 2026

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.

Add to ~/.claude.json

~/.claude.json
json
{
  "mcpServers": {
    "outline": {
      "command": "uvx",
      "args": [
        "mcp-outline"
      ],
      "env": {
        "OUTLINE_API_KEY": "<OUTLINE_API_KEY>",
        "OUTLINE_API_URL": "<OUTLINE_API_URL>"
      }
    }
  }
}
Or via CLI
bash
claude mcp add outline -- uvx mcp-outline

Available tools

ToolDescription
search_documentsSearches documents by keyword across the workspace.
list_collectionsLists the collections in the workspace.
get_collection_structureReturns the document hierarchy within a collection.
get_document_id_from_titleResolves a document title to its ID.
read_documentReads the content of a document.
export_documentExports a document, for example as Markdown.
create_documentCreates a new document.
update_documentUpdates an existing document's content or metadata.
move_documentMoves a document to a different collection or parent.
archive_documentArchives a document.
unarchive_documentRestores a document from the archive.
delete_documentSends a document to the trash.
restore_documentRestores a document from the trash.
list_archived_documentsLists the archived documents.
list_trashLists the documents currently in the trash.
add_commentAdds a comment to a document.
list_document_commentsLists the comments on a document.
get_commentRetrieves a single comment.
get_document_backlinksLists documents that link to a given document.
create_collectionCreates a new collection.
update_collectionUpdates a collection's properties.
delete_collectionDeletes a collection.
export_collectionExports an entire collection.
export_all_collectionsExports all collections in the workspace.
batch_create_documentsCreates multiple documents in one call.
batch_update_documentsUpdates multiple documents in one call.
batch_move_documentsMoves multiple documents in one call.
batch_archive_documentsArchives multiple documents in one call.
batch_delete_documentsDeletes multiple documents in one call.
ask_ai_about_documentsAsks 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.
← Browse all knowledge-base servers