Outline Wiki

npm version Docker License: ISC MCP

An MCP server for Outline wiki — search, read, create, and manage documents from any LLM client.

What is this about?

A Model Context Protocol server that connects LLM applications to your Outline wiki. Supports both stdio (for local tools like Claude Desktop, Claude Code) and HTTP transport (for remote clients like Claude.ai web).

Features

• Full-text Search – Find documents across your entire wiki
• Document Management – Create, read, update, delete, and move documents
• Collection Organization – Browse and manage document collections
• Archive & Restore – Soft-delete with archive/restore functionality
• Draft Access – Work with unpublished drafts
• Markdown Export – Export documents as clean markdown
• MCP Resources – Browse collections and documents via resource URIs
• Dual Transport – Run as a local stdio server or remote HTTP service

Installation

npx (stdio)

Zero-install, runs locally via stdio transport:

OUTLINE_BASE_URL=https://your-instance.getoutline.com \
OUTLINE_API_KEY=ol_api_xxx \
npx -y outline-wiki-mcp

Docker (HTTP)

Pull the pre-built image from GHCR and run in HTTP mode:

docker run -d \
  -p 9999:9999 \
  -e OUTLINE_BASE_URL=https://your-instance.getoutline.com \
  -e OUTLINE_API_KEY=ol_api_xxx \
  ghcr.io/raisedadead/outline-wiki-mcp:latest

The MCP endpoint will be available at http://localhost:9999/mcp.

Docker Compose

Create a .env file with your credentials:

OUTLINE_BASE_URL=https://your-instance.getoutline.com
OUTLINE_API_KEY=ol_api_xxx

Then start the service:

docker compose up -d

The docker-compose.yml included in the repository:

services:
  outline-wiki-mcp:
    image: ghcr.io/raisedadead/outline-wiki-mcp:latest
    ports:
      - "${PORT:-9999}:9999"
    environment:
      - OUTLINE_BASE_URL=${OUTLINE_BASE_URL}
      - OUTLINE_API_KEY=${OUTLINE_API_KEY}
      - MCP_TRANSPORT=http
      - PORT=9999
    restart: unless-stopped

Quick Start

Prerequisites

• Outline instance (cloud or self-hosted)
• API key from Outline > Settings > API > Create API Key

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": ["-y", "outline-wiki-mcp"],
      "env": {
        "OUTLINE_BASE_URL": "https://your-instance.getoutline.com",
        "OUTLINE_API_KEY": "ol_api_xxx"
      }
    }
  }
}

Claude Code CLI (stdio)

claude mcp add \
  -e OUTLINE_BASE_URL=https://your-instance.getoutline.com \
  -e OUTLINE_API_KEY=ol_api_xxx \
  -s user \
  outline -- npx -y outline-wiki-mcp

Claude Code CLI (HTTP)

First start the server in HTTP mode (using Docker or npx), then add the remote endpoint:

claude mcp add -s user --transport http outline http://localhost:9999/mcp

Claude.ai Web

Add as a remote MCP server in Claude.ai settings using the HTTP endpoint URL:

http://localhost:9999/mcp

Replace localhost:9999 with your deployed server address.

Configuration

Option	CLI Flag	Environment Variable	Default
Transport	--transport	MCP_TRANSPORT	stdio
Port	--port	PORT	9999
Base URL	-	OUTLINE_BASE_URL	-
API Key	-	OUTLINE_API_KEY	-

A JSON config file can also be used for Outline credentials:

npx outline-wiki-mcp --config /path/to/config.json

{
  "outline": {
    "baseUrl": "https://your-instance.getoutline.com",
    "apiKey": "ol_api_xxx"
  }
}

Precedence rules:

1. Config file values override environment variables for Outline credentials
2. CLI flags (--transport, --port) override environment variables
3. Environment variables (MCP_TRANSPORT, PORT) override defaults

Tools

Document Operations

Tool	Description
outline_search	Full-text search across all documents
outline_get_document	Retrieve document content by ID
outline_list_documents	List documents in a collection
outline_create_document	Create a new document
outline_update_document	Update an existing document
outline_move_document	Move document to a different collection
outline_delete_document	Permanently delete a document
outline_archive_document	Archive a document (soft delete)
outline_unarchive_document	Restore an archived document
outline_list_drafts	List all unpublished drafts
outline_export_document	Export document as clean markdown

Collection Operations

Tool	Description
outline_list_collections	List all collections
outline_get_collection	Get collection details by ID
outline_create_collection	Create a new collection
outline_update_collection	Update collection properties
outline_delete_collection	Delete a collection

Resources

Browse your wiki structure using MCP resource URIs:

URI Pattern	Description
outline://collections	List all collections
outline://collections/{id}	Collection details with documents
outline://documents/{id}	Document content in markdown

Contributing

See CONTRIBUTING.md for details.

License

ISC License - see LICENSE file for details.