b3nw 176e1f1040
Build and Push Outline MCP Docker Image / build (push) Successful in 7s
feat: Add embedMarkdown to upload response and document attachment format
The upload response now includes an embedMarkdown field with the correct
Outline attachment syntax ([name size](/api/attachments.redirect?id=...))
so callers can insert it directly into documents for native card rendering.

IMPLEMENTATION.md updated with storage backend details, auth header,
and embedding format documentation.
2026-05-25 02:52:49 +00:00

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

S
Description
MCP server for Outline knowledge base
Readme 118 KiB
Languages
Python 97.8%
Dockerfile 2.2%