outline-mcp
Provides tools to search and read documents from an Outline wiki, including full-text search across documents, reading document content, and listing collections.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
outline-mcp
MCP server for Outline — gives Claude the ability to search and read documents from your Outline instance.
Tools
Tool | Description |
| Full-text search across all documents. Returns title, excerpt, and URL for each result. |
| Reads the full content of a document in Markdown. Accepts document ID or URL. |
| Lists all available collections in the workspace. |
Related MCP server: Outline MCP Server
Requirements
Docker and Docker Compose
An Outline API token (see below)
Setup
1. Get your API token
In Outline: Settings → API Tokens → Create token
2. Clone and configure
git clone https://github.com/ngarbezza/outline-mcp.git
cd outline-mcp
cp .env.example .envEdit .env:
OUTLINE_URL=https://your-outline-instance.com
OUTLINE_API_TOKEN=your_token_here3. Start the server
docker compose up -dVerify it's running:
curl http://localhost:8000/health
# {"status": "ok", "server": "outline-mcp"}Connecting to Claude
Claude Code
claude mcp add outline --transport sse http://localhost:8000/sseClaude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"outline": {
"url": "http://localhost:8000/sse"
}
}
}Restart Claude Desktop after saving.
Claude.ai (web)
Claude.ai requires a publicly accessible URL. Use a tunnel to expose your local server:
# Option A: cloudflared (recommended, free)
cloudflared tunnel --url http://localhost:8000
# Option B: ngrok
ngrok http 8000Then go to Claude.ai → Settings → Integrations → Add MCP and enter the tunnel URL.
Note: The tunnel URL changes every time you restart it. For a stable setup, configure a named cloudflared tunnel or use ngrok with a reserved domain.
Usage examples
Once connected, you can ask Claude things like:
"Search Outline for our onboarding process"
"What does the API design guidelines document say?"
"List all collections in Outline"
"Read the document at https://outline.yourcompany.com/doc/..."
Troubleshooting
curl /health returns connection refused
The container isn't running. Check with docker compose ps and inspect logs with docker compose logs.
Claude says the tool is unavailable
Claude Desktop: make sure you restarted the app after editing the config file.
Claude Code: run
claude mcp listto verify the server is registered.All clients: confirm the server is running with
curl http://localhost:8000/health.
401 Unauthorized errors from Outline
Your API token is invalid or expired. Generate a new one in Outline under Settings → API Tokens.
403 Forbidden on specific documents
The token belongs to a user that doesn't have access to that collection. Check permissions in Outline.
Search returns no results Outline's search indexes documents asynchronously. Newly created documents may take a few minutes to appear. Also verify your token has read access to the collections you're searching.
Tunnel URL keeps changing (Claude.ai)
Use a named cloudflared tunnel with a fixed subdomain, or run the MCP server on a VPS and point Claude.ai directly to it.
Development
To run the server locally without Docker:
pip install -r requirements.txt
export OUTLINE_URL=https://your-outline-instance.com
export OUTLINE_API_TOKEN=your_token_here
python src/server.pyLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Hosted Notion MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Zotero MCP server for Claude and ChatGPT: search, citations, safe writes, PDF passages and pages.
Related MCP Servers
- AlicenseAqualityCmaintenanceA Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.38716 PyPI159MIT
- 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
- 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-
- FlicenseNot gradedqualityDmaintenanceMCP server for reading and searching Markdown notes in any directory, such as an Obsidian vault. It integrates with MCP clients like Claude Desktop to access note contents.-