Outline

Outline

A MCP server to interact with Outline knowledge base: search, read, create, and manage documents, collections, comments,

57
Stars
19
Forks
8
Releases

Overview

The MCP Outline Server is a Model Context Protocol server designed to work with an Outline knowledge base for comprehensive document management. It exposes MCP tools to perform document operations (search, read, create, edit, archive), manage collections and their hierarchical structure, and collaborate through threaded comments. It also supports backlinks discovery to identify documents that reference a given document. Direct content and metadata access is provided via MCP Resources URIs (outline://document/{id}, outline://collection/{id}, etc.), enabling lightweight integrations with clients. The server implements automatic rate limiting with header-based tracking and exponential backoff retry, easing API usage across multiple clients. Transport modes include stdio for local use, SSE for web clients, and streamable-http for remote access. Access control is configurable: enabling read-only mode disables all write operations; there is also an option to disable delete operations while permitting create and update workflows. It requires an Outline API key and can connect to cloud-hosted or self-hosted Outline instances via configurable API URL. The project includes deployment guidance for uv-based execution and Docker, and supports common MCP client environments (Claude, Cursor, VS Code, Cline) with development and testing tooling.

Details

Owner
Vortiago
Language
Python
License
MIT License
Updated
2025-12-07

Features

Document operations

Search, read, create, edit, and archive documents.

Collections management

List, create, and manage document hierarchies.

Comments and collaboration

Add and view threaded comments on documents.

Backlinks

Find documents that reference a specific document.

MCP Resources

Direct content access via URIs like outline://document/{id} and outline://collection/{id}.

Automatic rate limiting

Transparent handling of API limits with exponential backoff retry.

Transport modes

Supports stdio, SSE, and streamable-http transports.

Access control and safety

Read-only mode and delete operation controls via OUTLINE_READ_ONLY and OUTLINE_DISABLE_DELETE.

Tags

OutlineMCPdocument managementcollectionscommentsbacklinksoutline:// URIsrate limitingtransport modesstdiossestreamable-httpAPI keyDockerOutline APIAI tools