-
securityF
license-
qualityA Model Context Protocol server utilizing Claude AI for generating intelligent queries and offering documentation assistance based on API documentation analysis.
Last updated -
4
3
The MCP Outline Server enables AI assistants to interact with Outline's document management system with these capabilities:
Document Operations: Create, read, update, move, archive/unarchive, delete, and restore documents, including nested hierarchies
Search and Navigation: Search by keywords, list collections, view document structures, and retrieve document IDs from titles
Export Functions: Export documents or collections in markdown, JSON, or HTML format
Comment Management: View, add, and retrieve comments on documents with pagination support
Collection Management: Create, update, delete, and organize collections containing documents
Relationship Tools: View backlinks (documents that link to a specific document)
AI Integration: Query document content using natural language questions
MCP Outline Server
A Model Context Protocol (MCP) server enabling AI assistants to interact with Outline (https://www.getoutline.com)
Overview
This project implements a Model Context Protocol (MCP) server that allows AI assistants (like Claude) to interact with Outline document services, providing a bridge between natural language interactions and Outline's document management capabilities.
Features
Currently implemented:
Document Search: Search for documents by keywords
Collection Management: List collections and view document structure
Document Reading: Read document content, export as markdown
Comment Management: View and add comments on documents
Document Creation: Create new documents in collections
Document Editing: Update document content and move documents
Backlink Management: View documents that link to a specific document
Getting Started
Prerequisites
Python 3.10+
Outline account with API access
Outline API key (get this from your Outline account settings)
Installation
# Clone the repository
git clone https://github.com/Vortiago/mcp-outline.git
cd mcp-outline
# Install in development mode
uv pip install -e ".[dev]"
Configuration
Create a .env file in the project root with the following variables:
# Outline API Configuration
OUTLINE_API_KEY=your_outline_api_key_here
# For cloud-hosted Outline (default)
# OUTLINE_API_URL=https://app.getoutline.com/api
# For self-hosted Outline
# OUTLINE_API_URL=https://your-outline-instance.example.com/api
Running the Server
# Development mode with the MCP Inspector
mcp dev src/mcp_outline/server.py
# Or use the provided script
./start_server.sh
# Install in Claude Desktop (if available)
mcp install src/mcp_outline/server.py --name "Document Outline Assistant"
Usage Examples
Search for Documents
Search for documents containing "project planning"
List Collections
Show me all available collections
Read a Document
Get the content of document with ID "docId123"
Create a New Document
Create a new document titled "Research Report" in collection "colId456" with content "# Introduction\n\nThis is a research report..."
Add a Comment
Add a comment to document "docId123" saying "This looks great, but we should add more details to the methodology section."
Move a Document
Move document "docId123" to collection "colId789"
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Development
# Run tests
uv run pytest tests/
# Format code
uv run ruff format .
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
Built with MCP Python SDK
Uses Outline API for document management
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.Last updated -122261
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to access and search Atlassian Confluence content, allowing integration with your organization's knowledge base.Last updated -751131
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Confluence content, supporting operations like retrieving, searching, creating, and updating pages and spaces.Last updated -97MIT License