Outline MCP Server

A Model Context Protocol (MCP) server that integrates Outline Wiki with AI assistants like Claude Desktop.

Features

• 🔍 Search documents - Find documents in your Outline knowledge base

• 📝 Create documents - Create new documents in any collection

• ✏️ Update documents - Update existing documents (with append support)

• 📁 List collections - View all accessible collections

• 📚 Resources - Access document content and search results as resources

• 💡 Prompts - Pre-configured prompts for document analysis and content creation

Setup

1. Install dependencies:

   cd outline-mcp-server
   python -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt

2. Configure environment: Create a .env file with your Outline API token:

   OUTLINE_TOKEN=your_api_token_here
   OUTLINE_BASE_URL=https://your-outline-instance.com/api

3. Test the server:

   python test_server.py

Claude Desktop Integration

The server has been configured in ~/.config/claude-desktop/claude.json.

To use it:

1. Restart Claude Desktop

2. The Outline tools should appear in the tools menu

3. Try commands like:

   • "Search for documentation about [topic]"

   • "List all collections in Outline"

   • "Create a new document about [topic] in [collection]"

Available Tools

search_documents

Search for documents in Outline.

• query: Search query

• limit: Maximum results (default: 10)

create_document

Create a new document.

• title: Document title

• content: Document content (Markdown)

• collection_id: Target collection ID

update_document

Update an existing document.

• doc_id: Document ID

• content: New content

• append: Append to existing content (default: false)

list_collections

List all accessible collections.

Resources

• outline://document/{doc_id} - Get full document content

• outline://search/{query} - Get search results as JSON

Prompts

• analyze_document - Analyze a document with various analysis types

• create_overview - Create a topic overview from related documents

Development

The server consists of:

• server.py - Main MCP server implementation

• outline_client.py - Outline API client

• tools.py - Tool implementations

• resources.py - Resource handlers

• prompts.py - Prompt templates

• test_server.py - Test script

Troubleshooting

1. Server won't start: Check that OUTLINE_TOKEN is set in .env

2. Connection errors: Verify OUTLINE_BASE_URL is correct

3. Claude Desktop doesn't show tools: Restart Claude Desktop after config changes