Files
outline-mcp-custom/README.md
Ben 5da443cef7
Some checks failed
Build and Push Docker Image / build (push) Failing after 0s
Initial commit: Outline MCP server with hybrid light pattern
2025-12-30 19:36:17 +00:00

1.4 KiB

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