outline-mcp
Docs

Outline MCP User Guide

Run Outline with MCP.Cloud and self-hosted, one workflow.

outline-mcp is a production-focused MCP server for Outline workspaces. Configure once, connect your MCP client, and operate with explicit read/write/delete controls.

Built for real agent workflows

Permission-first runtime

Restrict capabilities with OUTLINE_ALLOWED_ACTIONS so each agent only sees and runs what it should.

Cloud + self-hosted

Switch endpoints with OUTLINE_BASE_URL. Keep the same tools and contracts across environments.

Safe concurrency

Use safe_update_document and lease tools to avoid silent overwrites in multi-agent collaboration.

Operationally complete

Collections, documents, templates, comments, memberships, and export flows are all documented and available.

From setup to production usage

Production Ready
  1. 1

    Install and connect

    Add @sigee-min/outline-mcp to your MCP client using npx or global install.

  2. 2

    Apply environment policy

    Set API key, endpoint, and allowed actions to match your trust boundary and deployment model.

  3. 3

    Run guided operations

    Use user guides for collection/document workflows, membership operations, and export processing.

  4. 4

    Validate with E2E

    Run Inspector scenarios with isolated temp collections to verify behavior before team rollout.

Operational Principles

  • Keep permissions explicit: read-only agents should never receive write/delete capabilities.
  • Use safe_update_document or lease flows for any concurrent edit path.
  • Prefer temporary resources during validation to avoid impact on live collections.

Start Here

Follow these pages in order for first-time setup and team rollout.

Ship fast, operate safely.

Start with the installation guide, then move to tool reference and multi-agent operations for production.