mcp-outline
It is an MCP server that lets AI clients search, read, create, update, and organize documents in an Outline wiki.
List and inspect collections, including document trees
Full-text search documents (returns snippets, not bodies)
Fetch a document's full markdown body by id, urlId, or share id
List documents filtered by collection or parent document
Create documents from markdown, with draft or published status and optional nesting
Update document title/body, append text, or publish drafts
Move documents between collections and parents
Archive documents; delete documents only when explicitly enabled
Configure via interactive setup, config file, or environment variables
Enables search, reading, creation, updating, moving, archiving, and optional deletion of Outline wiki documents and collections through the Outline API, including document tree browsing and markdown content management.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-outline search our wiki for onboarding docs"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@fswap/mcp-outline
An MCP server for Outline that lets Claude Desktop, Claude Code, Cursor and other MCP clients search, read, create and update your wiki.
Runs locally over stdio. No install step — clients launch it with npx.
Quick start
Create an API token in Outline under Settings → API.
Run the interactive setup once:
npx -y @fswap/mcp-outline@latest setupIt asks for your Outline URL and token, verifies them against
auth.info, and stores them in your OS config directory (mode0600).Add the server to your client. At the end,
setupoffers to do this for you in Claude Code, Claude Desktop, Cursor and Codex: clients it finds are pre-selected (except Claude Code when Claude Desktop is installed, because the desktop app's Code tab already loadsclaude_desktop_config.json), an existingoutlineentry is only replaced after you confirm, and any config file it changes gets a one-time.bakcopy.To add it by hand instead, use the snippets below. Every value asked in
setupcan be skipped with Enter; anything you skip goes into theenvblock instead.setup --printshows these snippets again at any time.Claude Desktop (
claude_desktop_config.json) and Cursor (~/.cursor/mcp.jsonor<project>/.cursor/mcp.json):{ "mcpServers": { "outline": { "command": "npx", "args": ["-y", "@fswap/mcp-outline@latest"] } } }Codex (
~/.codex/config.toml):[mcp_servers.outline] command = "npx" args = ["-y", "@fswap/mcp-outline@latest"]Claude Code:
claude mcp add outline -- npx -y @fswap/mcp-outline@latest
Without setup (environment variables)
Environment variables take precedence over the config file, so you can skip setup entirely (or skip individual values in it and set them here):
{
"mcpServers": {
"outline": {
"command": "npx",
"args": ["-y", "@fswap/mcp-outline@latest"],
"env": {
"OUTLINE_URL": "https://app.getoutline.com",
"OUTLINE_API_TOKEN": "ol_api_..."
}
}
}
}Codex equivalent:
[mcp_servers.outline]
command = "npx"
args = ["-y", "@fswap/mcp-outline@latest"]
[mcp_servers.outline.env]
OUTLINE_URL = "https://app.getoutline.com"
OUTLINE_API_TOKEN = "ol_api_..."Variable | Purpose |
| Outline base URL (cloud or self-hosted) |
| API token |
|
|
| Optional default collection name |
Related MCP server: outline-mcp
Tools
Tool | Outline endpoint | Notes |
|
| id, name, description, url |
|
| includes document tree |
|
| query, optional |
|
| full markdown body; accepts id or URL slug |
|
| filter by |
|
| title, markdown, collection, optional parent; published by default |
|
| title/text; |
|
| change collection and/or parent |
|
| reversible |
|
| only when delete is allowed (setup answer or |
API errors are returned to the model as isError results rather than crashing the server.
Development
TypeScript source in src/, bundled to dist/ with tsdown. Only dist/ is published.
npm install
npm run build # tsdown → dist/index.js
npm run lint # eslint (typescript-eslint)
npm run typecheck # tsc --noEmit
npm test # builds, then spawns the server and checks the tool list
npm run check # all of the above (also runs on prepublishOnly)
OUTLINE_URL=... OUTLINE_API_TOKEN=... npm run inspect # MCP Inspector UI against dist/Never write to stdout from server code — it is the protocol channel. Use console.error.
Reset
npx -y @fswap/mcp-outline@latest setup --resetLicense
MIT
Available Tools
9 toolsarchive_documentArchive documentA
Archive a document (reversible; it disappears from the collection but can be restored from the archive). Prefer this over delete_document.
Inputs: id (required).
create_documentCreate documentA
Create a new Outline document from markdown. Published by default; pass publish=false to save a draft. Requires a collectionId (use list_collections). Optionally nest under a parent document.
Inputs: title (required), collectionId (required), text, publish, +1 more.
get_collectionGet collectionA
Get one Outline collection including its document tree (ids, titles and nesting). Useful to understand how a collection is organised before creating or moving documents.
Inputs: id (required).
get_documentGet documentA
Fetch a single Outline document including its full markdown body. Accepts a document id, a urlId (the slug part of the URL) or a share id.
Inputs: id (required).
list_collectionsList collectionsA
List Outline collections (top-level groupings of documents). Returns id, name, description and url. Use the id with search_documents, list_documents or create_document.
Inputs: limit, query.
list_documentsList documentsA
List documents, optionally filtered by collection and/or parent document. Returns id, title, url and timestamps (no bodies). Sorted by most recently updated by default.
Inputs: sort, limit, offset, direction, +2 more.
move_documentMove documentB
Move a document to another collection and/or under a different parent document. Omit parentDocumentId to move it to the top level of the collection.
Inputs: id (required), index, collectionId, parentDocumentId.
search_documentsSearch documentsA
Full-text search across Outline documents. Returns id, title, url and a short context snippet per hit. Does NOT return document bodies — call get_document with an id to read one.
Inputs: query (required), limit, offset, collectionId.
update_documentUpdate documentA
Update an existing document's title and/or markdown body. By default text REPLACES the body; set append=true to add text to the end instead. Only the fields you pass are changed.
Inputs: id (required), done, text, title, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a clearly distinct action-resource pairing: list/search/get/list-collections for reads, create/update/move/archive for writes. The only mild overlap is list_documents vs search_documents, but descriptions make the boundary explicit (metadata listing vs full-text search with snippets) and search_documents points to get_document for bodies.
All nine tools follow a strict snake_case verb_noun pattern (list_collections, get_collection, list_documents, create_document, update_document, move_document, archive_document, search_documents, get_document) with no exceptions or mixed conventions.
Nine tools is well-scoped for an Outline document service, covering both the collection and document resources without redundancy. Every tool earns its place, none feels like filler.
The document lifecycle is largely covered (list, search, get, create, update, move, archive), plus collection reads. However, there is no collection creation/update and no explicit unarchive/restore or hard delete, leaving minor gaps agents must work around; archive is documented as reversible but no restore tool is exposed.
Maintenance
Related MCP Connectors
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Hosted Notion MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that enables reading, writing, and searching documents in Outline via its API. It supports document management, full-text search, and collection organization using Markdown formatting.834 npm17MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for Outline that gives Claude the ability to search and read documents from your Outline instance.MIT
- FlicenseBqualityDmaintenanceA Model Context Protocol server that exposes an Outline knowledge base to MCP clients. It enables searching, reading, writing, and commenting on documents through natural language.9-
- AlicenseNot gradedqualityCmaintenanceMCP server that turns a self-hosted Outline wiki into an AI team's knowledge base, providing tools for search, read, write, and organization with per-user permissions via client-supplied API tokens.MIT