nbhansen/outline-mcp-server

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