MCP Outline Server: your Outline wiki for agents
MCP Outline Server
A community server that connects Outline to MCP: an agent searches, reads, creates and edits documents and comments in your wiki
- 159 ★ on the repository
- Last commit
Broad access
Why this level
- With the API key an agent creates, edits, archives and deletes documents in your wiki unless read-only mode is on
- Wiki content reaches the model, including internal policies
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mcp-outline-serverDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- With the API key an agent creates, edits, archives and deletes documents in your wiki unless read-only mode is on
- Wiki content reaches the model, including internal policies
This is third-party code. Review the repository files before installing.
What it does
The server links an assistant to Outline, a documentation system with collections and documents. An agent searches, reads, creates, edits and archives documents, works with collections and hierarchies, adds and reads threaded comments and finds documents that link to a given one. Content is also available as resources at addresses like outline://document/{id} and outline://collection/{id}. Rate limits are handled transparently: the server retries calls itself when the API limit is hit. You need an Outline account (cloud or self-hosted) and an API key from Settings, API Keys. It runs through `uvx mcp-outline`, `pip install mcp-outline` or the ghcr.io/vortiago/mcp-outline container. The repository can be installed as a Claude Code plugin: with the server come the outline-explorer agent for fast wiki reading and an outline skill with formatting conventions (mermaid blocks, document structure, editing workflow). The author's own README recommends Outline's official MCP server, which the company now ships.
Who it is for. Teams that keep an internal knowledge base in Outline and want to search and update it from Claude Code, Claude Desktop or Cursor.
Good fit when
- You need to find a policy in the wiki and relay the answer with links to the documents
- You ask an agent to create a page from meeting notes in the right collection
- You need to check which documents link to an outdated page before archiving it
- You want read-only access to the wiki and discussions with no way to change anything
Not a fit when
- You are ready to move to Outline's official server: the author recommends it for new connections
- Your wiki lives in Confluence, Notion or another system: the server talks only to Outline
- You need exact per-document permissions for different people: the server uses a single API key
Example request
Find the vacation policy page in our Outline wiki, summarize the terms and show links to the documents.MCP
- Transport
- stdio, http, sse
- Authentication
- API key
Environment variables
OUTLINE_API_KEYrequired, secret- Outline API key from Settings, API Keys.
OUTLINE_API_URL- API address for a self-hosted server; defaults to Outline cloud.
OUTLINE_READ_ONLY- The value true disables all write operations.
Limitations
The author recommends Outline's official server, and this project remains community-made. You need an Outline account and an API key, and for a non-Docker install Python 3.10 or newer. `OUTLINE_VERIFY_SSL=false` suits only self-signed certificates on an internal network.
The server inherits the API key's rights, including writing and deleting, unless you turn them off. Restrict them with `OUTLINE_READ_ONLY` and `OUTLINE_DISABLE_DELETE`. Over HTTP and SSE the key can be passed per request in the `x-outline-api-key` header.
How to disable. Remove the server with `claude mcp remove mcp-outline` or from the client config, and revoke the API key in Outline under API Keys.
FAQ
How do I connect MCP Outline Server to Claude Code?
Run `claude mcp add mcp-outline uvx mcp-outline`, then set `OUTLINE_API_KEY`. If you install the repository as a plugin, the outline-explorer agent and the outline skill arrive with the server.
Where do I get an API key?
In Outline open your profile, Settings, API Keys and create a new key. Copy the token right after creation. For the cloud version the default address is `https://app.getoutline.com/api`.
How does this server differ from Outline's official MCP?
This is a community project: it does broadly the same job but is maintained by a separate author. The official server is shipped by Outline itself, and the README recommends using it.
How do I stop the agent from deleting or editing documents?
Set `OUTLINE_READ_ONLY=true` and all write operations are disabled. To block only deletion use `OUTLINE_DISABLE_DELETE=true`. A separate `OUTLINE_DISABLE_AI_TOOLS` switches off AI tools for Outline installs without OpenAI.
Does it work with a self-hosted Outline?
Yes. Set the API address in `OUTLINE_API_URL` as `https://your-domain/api`. For self-signed certificates there is `OUTLINE_VERIFY_SSL=false`, which is best used only inside a trusted network.
Discussion
No questions or reviews yet.
Related
MCP serversThe official Kibela MCP server searches, reads and edits notes, folders and comments of your wiki straight from an assistant chat
An MCP server for an Obsidian vault via the Local REST API plugin: search, read, append and patch notes
Workflowy MCP Server & CLI: Workflowy for agents
Workflowy MCP Server & CLI
One Go binary: an MCP server and CLI for Workflowy with regex search, bulk replace, reports and a read-only mode
AFFiNE MCP Server: AFFiNE notes and databases for agents
AFFiNE MCP Server
An MCP server for AFFiNE: the agent searches, creates and edits documents, databases and comments in cloud or self-hosted AFFiNE
Obsidian MCP Server
obsidian-mcp-server
An MCP server for an Obsidian vault: read, search and precisely edit notes, sections, frontmatter and tags
DoodleNote MCP: meeting notes for agents
DoodleNote MCP
A read-only MCP server: Claude Code, Claude Desktop and Codex search local DoodleNote meetings, notes and transcripts
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| MCP Outline Server: your Outline wiki for agents (this card) | no | API key | 159 | |
| Notion MCP (awkoy) | no | API key | 180 | a server for Notion rather than Outline |
| OpenWiki | no | 17,914 | a wiki generated from repository code, with no Outline connection |
README in short
The README has a banner about Outline's official server, a feature list (documents, collections, comments, backlinks, resources and retry on rate limits), requirements, install through uvx, pip or Docker, client setup and an environment variable table.