Outline MCP Server

A lightweight MCP server for interacting with self-hosted Outline knowledge bases.

Features

• 4 specific tools for common operations (search, get document, list collections)
• API passthrough for full Outline API coverage
• Embedded API reference resource for agent self-service
• Docker-ready with health checks

Tools

Tool	Description
search_documents	Full-text search across all documents
get_document	Retrieve a document by ID with Markdown content
list_collections	List all collections in the workspace
list_collection_documents	List documents within a specific collection
outline_api_call	Raw API passthrough for any Outline endpoint

Resources

URI	Description
outline://api-reference	Comprehensive Outline API documentation

Configuration

Copy .env.example to .env and configure:

OUTLINE_API_URL=https://docs.example.com
OUTLINE_API_TOKEN=your_api_token_here

Get your API token from Outline: Settings > API Tokens

Running

Docker Compose

docker compose up -d

Local Development

pip install -e .
python server.py

Health Check

curl http://localhost:8000/health

MCP Endpoint

The MCP server is available at http://localhost:8000/mcp

License

MIT