outline-wiki

This MCP server enables programmatic access to your Outline wiki through the Model Context Protocol. It supports both stdio (local tools like Claude Desktop and Claude Code) and HTTP transport (remote clients such as Claude.ai web). The server exposes a range of wiki document operations (search, read, create, update, delete, move, archive, restore) and collection management, as well as draft handling and markdown export. Tools exposed under the outline namespace allow you to search content, fetch documents, list and manage collections, and perform document lifecycle actions. You can run the server locally with npx (stdio) or expose it over HTTP via Docker or a Node-based start script, and then configure clients to connect either through stdio pipes or HTTP endpoints. The client configuration examples show how to register this MCP with Claude products or generic MCP clients, using either the stdio launcher command (npx outline-wiki-mcp) or an HTTP URL (http://host:port/mcp).

Prerequisites:

• Node.js with npm/yarn/pnpm (for stdio via npx) or Docker for HTTP mode
• Access to an Outline instance with an API key (outline-base-url and api-key)

Install and run in stdio mode (no installation required beyond your node environment):

# Set credentials as environment variables
export OUTLINE_BASE_URL=https://your-instance.getoutline.com
export OUTLINE_API_KEY=ol_api_xxx

# Run the MCP server using npx (stdio transport)
npx -y outline-wiki-mcp

Run in HTTP mode via Docker (pre-built image):

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.

Alternatively, run from source and build a local Docker image:

git clone https://github.com/raisedadead/outline-wiki-mcp.git
cd outline-wiki-mcp
pnpm install
pnpm build
# Build a local docker image (if you want to package it)
docker buildx bake

To run in stdio mode from source without Docker:

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

To run in HTTP mode from source:

export OUTLINE_BASE_URL=https://your-instance.getoutline.com
export OUTLINE_API_KEY=ol_api_xxx
pnpm start:http

Tips and considerations:

• Ensure OUTLINE_BASE_URL uses the correct Outline instance URL and OUTLINE_API_KEY is valid for API access.
• When running in HTTP mode behind a reverse proxy or load balancer, configure the public URL and TLS termination accordingly.
• The default HTTP port is 9999; you can override with PORT environment variable (e.g., PORT=8080).
• For Claude integration, you can register the MCP using the provided examples (Claude Desktop, Claude Code CLI) by pointing to the HTTP endpoint or using the stdio command for local usage.
• If you see authentication errors, verify that the API key has the necessary permissions and that the base URL is reachable from the host running the MCP server.
• The README shows a docker-compose snippet; you can adapt it for your environment by setting OUTLINE_BASE_URL, OUTLINE_API_KEY, and PORT as needed.