Which integrations are available for this server?

Allows interaction with Outline, a collaborative knowledge base and documentation platform, providing tools to manage collections, documents, comments, memberships, revision history, and more.

How do I use outline-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@outline-mcp search for server setup documents" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

outline-mcp

by sigee-min

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

outline-mcp

A production-focused MCP (stdio) server for Outline. Use it from MCP clients (Codex, Claude Desktop, Cursor, etc.) via npm without cloning this repo.

npm version Node.js License: MIT Docker

What Is Outline?

Outline is a collaborative knowledge base and documentation platform for teams. It is commonly used for internal docs, runbooks, product specs, onboarding guides, and shared process playbooks.

outline-mcp connects MCP clients to Outline workspaces so agents can safely read, update, and manage this knowledge through structured tools.

Related MCP server: Outline Wiki MCP Server

Install From npm

Package:

npm i -g @sigee-min/outline-mcp

Run:

outline-mcp

Or run without global install:

npx -y @sigee-min/outline-mcp

MCP Client Config (Copy/Paste)

{
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": ["-y", "@sigee-min/outline-mcp"],
      "env": {
        "OUTLINE_API_KEY": "your_api_key",
        "OUTLINE_BASE_URL": "https://app.getoutline.com",
        "OUTLINE_ALLOWED_ACTIONS": "read,write,delete"
      }
    }
  }
}

Environment Guides

Use this for app.getoutline.com workspaces.

OUTLINE_API_KEY=your_api_key
OUTLINE_BASE_URL=https://app.getoutline.com
OUTLINE_ALLOWED_ACTIONS=read,write,delete

Use your self-hosted endpoint.

OUTLINE_API_KEY=your_api_key
OUTLINE_BASE_URL=https://outline.your-company.internal
OUTLINE_ALLOWED_ACTIONS=read,write,delete

Use this when agents must never mutate content.

OUTLINE_API_KEY=your_api_key
OUTLINE_BASE_URL=https://app.getoutline.com
OUTLINE_ALLOWED_ACTIONS=read

Use this when agents can draft/edit but must not remove resources.

OUTLINE_API_KEY=your_api_key
OUTLINE_BASE_URL=https://app.getoutline.com
OUTLINE_ALLOWED_ACTIONS=read,write

Use this for cross-process lease coordination.

OUTLINE_API_KEY=your_api_key
OUTLINE_BASE_URL=https://app.getoutline.com
OUTLINE_ALLOWED_ACTIONS=read,write,delete
OUTLINE_LEASE_STRATEGY=data_attribute
OUTLINE_LEASE_ATTRIBUTE_ID=your_data_attribute_id
OUTLINE_LEASE_DEFAULT_TTL_SECONDS=600
OUTLINE_LEASE_MAX_TTL_SECONDS=7200

Supported Features (At a Glance)

Area	What you can do	Main MCP tools	Required action
Collections	List, create, update, delete collections	`list_collections`, `create_collection`, `update_collection`, `delete_collection`	`read`, `write`, `delete`
Documents	Search/read/create/update/move/delete documents	`search_documents`, `read_document`, `create_document`, `update_document`, `move_document`, `delete_document`	`read`, `write`, `delete`
Document Insights	Resolve IDs, structure, backlinks, and markdown export	`get_collection_structure`, `get_document_id_from_title`, `get_document_backlinks`, `export_document`	`read`
Document Lifecycle	Archive, unarchive, restore, and inspect archived/trash docs	`archive_document`, `unarchive_document`, `restore_document`, `list_archived_documents`, `list_trash`	`read`, `write`
Batch Operations	Execute create/update/move/archive/delete over many docs	`batch_create_documents`, `batch_update_documents`, `batch_move_documents`, `batch_archive_documents`, `batch_delete_documents`	`write`, `delete`
AI Search	Ask natural-language questions over docs in Outline	`ask_ai_about_documents`	`read`
Safe Concurrency	Prevent blind overwrite on concurrent edits	`safe_update_document`	`write`
Templates	Reuse template workflows	`list_templates`, `create_template_from_document`, `create_document_from_template`	`read`, `write`
Comments	Full comment lifecycle	`list_comments`, `get_comment`, `create_comment`, `update_comment`, `delete_comment`	`read`, `write`, `delete`
Memberships	Manage user/group access for docs and collections	`list__memberships`, `add_`, `remove_*`	`read`, `write`
Audit & Revisions	Track activity and revisions	`list_events`, `list_revisions`, `get_revision`	`read`
Export & File Ops	Run exports and fetch artifact status/URL	`export_collection`, `export_all_collections`, `list_file_operations`, `get_file_operation`, `download_file_operation`	`read`
MCP Resources	Read via URI templates without tool calls	`outline://collection/{id}`, `outline://collection/{id}/tree`, `outline://collection/{id}/documents`, `outline://document/{id}`, `outline://document/{id}/backlinks`	`read`
Lease Control	Acquire/renew/release document lease for agent coordination	`acquire_document_lease`, `renew_document_lease`, `release_document_lease`, `get_active_document_lease`	`write`

Supported Outline APIs (Mapped)

API Group	Outline endpoints used by outline-mcp
Collections	`collections.list`, `collections.info`, `collections.create`, `collections.update`, `collections.delete`, `collections.documents`
Collection Memberships	`collections.memberships`, `collections.group_memberships`, `collections.add_user`, `collections.remove_user`, `collections.add_group`, `collections.remove_group`
Documents	`documents.info`, `documents.search`, `documents.list`, `documents.create`, `documents.update`, `documents.move`, `documents.delete`, `documents.archive`, `documents.unarchive`, `documents.restore`, `documents.archived`, `documents.export`, `documents.answerQuestion`
Templates	`documents.templatize`, `documents.list` (`template=true`), `documents.create` (`templateId`)
Document Memberships	`documents.users`, `documents.memberships`, `documents.group_memberships`, `documents.add_user`, `documents.remove_user`, `documents.add_group`, `documents.remove_group`
Comments	`comments.list`, `comments.info`, `comments.create`, `comments.update`, `comments.delete`
Events/Revisions	`events.list`, `revisions.list`, `revisions.info`
Export/File Operations	`collections.export`, `collections.export_all`, `fileOperations.list`, `fileOperations.info`, `fileOperations.redirect`

Key Environment Variables

Variable	Default	Description
`OUTLINE_API_KEY`	none (required)	Outline API token
`OUTLINE_BASE_URL`	`https://app.getoutline.com`	Cloud or self-hosted endpoint
`OUTLINE_ALLOWED_ACTIONS`	`read,write,delete`	Allowed server actions
`OUTLINE_REQUEST_TIMEOUT_MS`	`15000`	API timeout in milliseconds
`OUTLINE_RETRY_COUNT`	`2`	Retry count for 429/5xx
`OUTLINE_ENABLE_CAPABILITY_PROBE`	`true`	Probe optional endpoints at startup
`OUTLINE_LEASE_STRATEGY`	`auto`	`auto` \| `memory` \| `data_attribute`
`OUTLINE_LEASE_ATTRIBUTE_ID`	none	Required for `data_attribute` lease strategy
`OUTLINE_LEASE_DEFAULT_TTL_SECONDS`	`600`	Default lease TTL
`OUTLINE_LEASE_MAX_TTL_SECONDS`	`7200`	Maximum lease TTL

Local Development (Monorepo)

git clone <repo-url>
cd outline-mcp
pnpm install
pnpm --filter @sigee-min/outline-mcp build
pnpm --filter @sigee-min/outline-mcp dev

Testing

pnpm test
pnpm typecheck
pnpm build
pnpm e2e:mcp

E2E notes:

Loads .env, .env.local, .env.e2e from root and apps/mcp
If OUTLINE_E2E_COLLECTION_ID is not set, it creates a temporary collection and cleans it up automatically

CI E2E notes:

.github/workflows/ci.yml runs MCP inspector E2E as a separate job when OUTLINE_API_KEY secret exists
Default CI mode is read-focused (OUTLINE_E2E_RUN_WRITE=false), configurable via GitHub Actions variable
Recommended GitHub settings:
- Secret: OUTLINE_API_KEY (required)
- Variables (optional): OUTLINE_BASE_URL, OUTLINE_E2E_RUN_WRITE, OUTLINE_E2E_COLLECTION_ID, OUTLINE_E2E_MEMBER_COLLECTION_ID, OUTLINE_E2E_MEMBER_USER_ID, OUTLINE_E2E_MEMBER_GROUP_ID

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessSyncing

Resources

Need Help?

Related Servers

Related MCP Connectors

hiveWikiOAuth
ai.hivewiki
Shared project wiki for AI agents: read and write pages, next actions, and activity logs over MCP.
Knowledge & Memory Note Taking Project Management
2
mcp
com.skopik
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
Agent Orchestration Knowledge & Memory Search
2
writespace-mcp
io.github.write-space
Persistent docs and memory for AI agents — read, write, organize & search a shared workspace.
Knowledge & Memory Note Taking
2
WitWikiOAuth
app.witwiki
A shared team wiki your coding agents read and write — across every repo and every MCP client.
Workplace & Productivity Knowledge & Memory Note Taking
1

Related MCP Servers

Outline Wiki MCP Server
Content Management Systems RAG Systems Note Taking
huiseo
F
license
C
quality
Not graded
maintenance
Enables LLMs to interact with Outline wiki for document management, search, collections, and comments, with optional AI-powered features including RAG-based Q\&A and content summarization.
Updated 9 months ago (2025-12-14 02:49 UTC)
37
403 npm
-
Outline Wiki MCP Server
RAG Systems Documentation Access Note Taking
huiseo
A
license
B
quality
D
maintenance
Enables LLMs to interact with Outline wiki for document management, search, and collections, with optional AI-powered features including RAG-based Q\&A, semantic search, and document summarization.
Updated 8 months ago (2026-01-12 10:09 UTC)
37
34 npm
1
MIT
Outline MCP Server
Content Management Systems Documentation Access Note Taking
HelicopterHelicopter
A
license
A
quality
D
maintenance
An MCP server that enables reading, writing, and searching documents in Outline via its API. It supports document management, full-text search, and collection organization using Markdown formatting.
Updated 4 months ago (2026-05-28 08:31 UTC)
8
15 npm
17
MIT
mcp-outline
Search Knowledge & Memory
ytrafimovich
F
license
B
quality
D
maintenance
Enables Claude Code to search and retrieve documents from an Outline knowledge base.
Updated 4 months ago (2026-05-11 12:38 UTC)
2
-

outline-mcp

What Is Outline?

Install From npm

MCP Client Config (Copy/Paste)

Environment Guides

Supported Features (At a Glance)

Supported Outline APIs (Mapped)

Key Environment Variables

Local Development (Monorepo)

Testing

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Outline Wiki MCP Server

Outline Wiki MCP Server

Outline MCP Server

mcp-outline