
Outline Mcp
Gives Claude a persistent tree-structured knowledge base that survives across sessions. You build nested sections and content nodes with properties, then mark nodes with inject=true to auto-include their content in every conversation. The toc command shows numbered IDs (1, 1-2, 2-1) for easy reference. Includes node_query for filtering by properties, snapshot_create for versioning entire trees, and node_history for per-node change logs. Export to Markdown checklists or JSON for backup. Useful when you need Claude to remember project conventions, coding standards, or runbook procedures without re-pasting them every session. Stores everything in a local JSON file with atomic writes.
- tools
- 33
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Oct 31, 2026
Tools
33 toolsPublic tool metadata for what this MCP can expose to an agent.
shelfList the books on the shelf.
List the books on the shelf.
No parameter schema in public metadata yet.
select_bookSelect a book; nodes with inject=true have their body auto-appended.
Select a book; nodes with inject=true have their body auto-appended.
No parameter schema in public metadata yet.
tocView the table of contents with numbered IDs, filters, depth and limit options.
View the table of contents with numbered IDs, filters, depth and limit options.
No parameter schema in public metadata yet.
node_createAdd a section or content node, optionally with properties.
Add a section or content node, optionally with properties.
No parameter schema in public metadata yet.
node_updateEdit title, body, type, placeholder, properties, or status of a node.
Edit title, body, type, placeholder, properties, or status of a node.
No parameter schema in public metadata yet.
node_moveRelocate or delete nodes; supports dry_run.
Relocate or delete nodes; supports dry_run.
No parameter schema in public metadata yet.
node_batch_moveMove multiple nodes in a single atomic call.
Move multiple nodes in a single atomic call.
No parameter schema in public metadata yet.
node_batch_updateUpdate title/body/type/properties/status on multiple nodes atomically.
Update title/body/type/properties/status on multiple nodes atomically.
No parameter schema in public metadata yet.
node_querySearch nodes by property values, status, type, text, or verification date.
Search nodes by property values, status, type, text, or verification date.
No parameter schema in public metadata yet.
importImport a book from a previously exported JSON file.
Import a book from a previously exported JSON file.
No parameter schema in public metadata yet.
initCreate a new empty book.
Create a new empty book.
No parameter schema in public metadata yet.
book_updateChange a book's title and/or max_depth.
Change a book's title and/or max_depth.
No parameter schema in public metadata yet.
book_deleteDelete a book with its nodes, history and snapshots.
Delete a book with its nodes, history and snapshots.
No parameter schema in public metadata yet.
gen_routingGenerate a Markdown routing table from nodes with routing property.
Generate a Markdown routing table from nodes with routing property.
No parameter schema in public metadata yet.
checklistExport a section or the whole book as a Markdown checklist.
Export a section or the whole book as a Markdown checklist.
No parameter schema in public metadata yet.
snapshot_createCreate a full book snapshot.
Create a full book snapshot.
No parameter schema in public metadata yet.
snapshot_listList book snapshots.
List book snapshots.
No parameter schema in public metadata yet.
snapshot_restoreRestore a book from a snapshot.
Restore a book from a snapshot.
No parameter schema in public metadata yet.
snapshot_deleteDelete a snapshot.
Delete a snapshot.
No parameter schema in public metadata yet.
node_historyView per-node change log with before/after diffs.
View per-node change log with before/after diffs.
No parameter schema in public metadata yet.
dumpExport full book as JSON file.
Export full book as JSON file.
No parameter schema in public metadata yet.
node_locateFind which book holds a node by UUID or short id prefix.
Find which book holds a node by UUID or short id prefix.
No parameter schema in public metadata yet.
book_lintRead-only structural checks on a book.
Read-only structural checks on a book.
No parameter schema in public metadata yet.
book_statsRead-only statistics for a book.
Read-only statistics for a book.
No parameter schema in public metadata yet.
node_verifyRecord that nodes were confirmed to still match reality.
Record that nodes were confirmed to still match reality.
No parameter schema in public metadata yet.
link_addAdd a typed link between nodes of a book.
Add a typed link between nodes of a book.
No parameter schema in public metadata yet.
link_removeRemove a typed link between nodes.
Remove a typed link between nodes.
No parameter schema in public metadata yet.
linksList outgoing links and backlinks of a node.
List outgoing links and backlinks of a node.
No parameter schema in public metadata yet.
revision_proposeAttach a proposed change to a node for review.
Attach a proposed change to a node for review.
No parameter schema in public metadata yet.
revision_showShow the diff of a pending revision against current content.
Show the diff of a pending revision against current content.
No parameter schema in public metadata yet.
revision_approveApply a pending revision to its node.
Apply a pending revision to its node.
No parameter schema in public metadata yet.
revision_rejectDrop a pending revision.
Drop a pending revision.
No parameter schema in public metadata yet.
revisions_pendingList pending revisions.
List pending revisions.
No parameter schema in public metadata yet.
Sponsors
Configuration
OUTLINE_MCP_DATABASE_URL*secretPostgres connection URL. Run `outline-mcp migrate` against it once before starting the server.
Readme
outline-mcp
Tree-structured knowledge base as an MCP server.
LLM sessions are ephemeral. outline-mcp gives them a persistent, editable knowledge tree — sections and content nodes that can be browsed (toc), annotated with properties, and evolved across sessions. Nodes with inject=true are automatically included in session context.
Quick Start
Books live in a Postgres database you run yourself. outline-mcp is a personal project published as-is: there is no hosted instance and no bundled database.
cargo install --path crates/outline-mcp
export OUTLINE_MCP_DATABASE_URL=postgres://user:pass@host:5432/outline
outline-mcp migrate # create / update the schema; run once per upgrade
outline-mcp # stdio
The server refuses to start when no database is configured, when the database cannot be reached (the message says whether the host is unreachable, the login was rejected, or the database does not exist), or when migrate has not been run against it. --database-url <url> overrides the environment variable on every subcommand.
Claude Code (~/.claude.json)
Details
- Repository
- github.com/ynishi/outline-mcp
- Category
- Documents & Knowledge
- Package
ghcr.io/ynishi/outline-mcp:0.15.3- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active