ynishi avatar

Outline Mcp

ynishi/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 tools

Public 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*secret

Postgres 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)


View the full README on GitHub

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

Related Documents & Knowledge MCP servers

View all
1deusdata avatarCodebase Memorydeusdata/codebase-memory-mcpCodebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.48.2Kstars
2builderio avatarAgent-Native Brainbuilderio/agent-nativeCited company knowledge from Slack, meetings, transcripts, and decisions7.6Kstars
3builderio avatarAgent-Native Contentbuilderio/agent-nativeOpen-source Obsidian for MDX - edit local docs with agent assistance7.6Kstars
4sooperset avatarAtlassiansooperset/mcp-atlassianProvides MCP access to Jira and Confluence data and actions via tokens and environment-based configuration.5.2Kstars
5revolist avatarRevoGrid DataGrid MCPrevolist/revogridToken-free MCP server for structured RevoGrid Core, Pro, and Enterprise knowledge retrieval.3.5Kstars
6coleam00 avatarCrawl4AI RAGcoleam00/mcp-crawl4ai-ragProvides web crawling, RAG, and knowledge-graph capabilities for AI agents with a Supabase-backed vector store.2.2Kstars