Outline Wiki 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

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

Collection Operations

Resources

Browse your wiki structure using MCP resource URIs:

Contributing

See CONTRIBUTING.md for details.

License

ISC License - see LICENSE file for details.