Outline Wiki MCP Server

English | | 日本語 | 中文

A Model Context Protocol (MCP) server that enables LLMs to interact with Outline wiki through structured API calls. This server provides document management, search, collections, comments, and AI-powered smart features including RAG-based Q&A.

Why This Server?

Most Outline MCP servers provide basic API wrappers. This one adds optional Smart Features:

When you might need this:

• Your team's wiki has grown large and search isn't enough
• You want to query your documentation conversationally
• You need semantic search across your knowledge base

When basic MCP is sufficient:

• You only need CRUD operations on documents
• You don't want to set up OpenAI API
• Your wiki is small and well-organized

Smart features require ENABLE_SMART_FEATURES=true and an OpenAI API key. Without these, the server works as a standard Outline MCP.

Example Usage

User: "What's our policy on remote work?"
 ask_wiki searches your wiki and returns an answer with source links

User: "Find documents related to the onboarding guide"
 find_related returns semantically similar docs (not just keyword matches)

User: "Summarize the Q4 planning document"
 summarize_document generates a concise summary in your preferred language

Supported Clients

Getting Started

Requirements

• Node.js 18.0.0 or higher
• Outline instance with API access
• (Optional) OpenAI API key for smart features

Getting Your Outline API Token

1. Log in to your Outline instance
2. Go to Settings API
3. Click Create API Key
4. Copy the generated token (starts with ol_api_)

Installation

<details> <summary>Claude Desktop</summary>

Add to your Claude Desktop configuration:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": ["-y", "outline-smart-mcp"],
      "env": {
        "OUTLINE_URL": "https://your-outline-instance.com",
        "OUTLINE_API_TOKEN": "ol_api_xxxxxxxxxxxxx"
      }
    }
  }
}

</details> <details> <summary>Claude Code</summary>

Run the following command:

claude mcp add outline -e OUTLINE_URL=https://your-outline-instance.com -e OUTLINE_API_TOKEN=ol_api_xxxxxxxxxxxxx -- npx -y outline-smart-mcp

Or add to ~/.claude.json (global) or .mcp.json (project-local):

{
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": ["-y", "outline-smart-mcp"],
      "env": {
        "OUTLINE_URL": "https://your-outline-instance.com",
        "OUTLINE_API_TOKEN": "ol_api_xxxxxxxxxxxxx"
      }
    }
  }
}

Note: The ~/.claude/settings.json file is ignored for MCP servers. Use ~/.claude.json or .mcp.json instead.

</details> <details> <summary>VS Code GitHub Copilot</summary>

Add to your VS Code settings (.vscode/mcp.json):

{
  "servers": {
    "outline": {
      "command": "npx",
      "args": ["-y", "outline-smart-mcp"],
      "env": {
        "OUTLINE_URL": "https://your-outline-instance.com",
        "OUTLINE_API_TOKEN": "ol_api_xxxxxxxxxxxxx"
      }
    }
  }
}

</details> <details> <summary>Cursor</summary>

Add to Cursor MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": ["-y", "outline-smart-mcp"],
      "env": {
        "OUTLINE_URL": "https://your-outline-instance.com",
        "OUTLINE_API_TOKEN": "ol_api_xxxxxxxxxxxxx"
      }
    }
  }
}

</details> <details> <summary>Windsurf</summary>

Add to Windsurf MCP settings (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": ["-y", "outline-smart-mcp"],
      "env": {
        "OUTLINE_URL": "https://your-outline-instance.com",
        "OUTLINE_API_TOKEN": "ol_api_xxxxxxxxxxxxx"
      }
    }
  }
}

</details> <details> <summary>ChatGPT Desktop</summary>

ChatGPT supports MCP through its desktop app. Add the server in Settings MCP Servers with:

• Command: npx
• Arguments: -y outline-smart-mcp
• Environment variables as shown above

</details>

Configuration

Environment Variables