MCP Outline Server
The MCP Outline Server enables AI assistants to interact with Outline's document management system with these capabilities:
Document Operations: Create, read, update, move, archive/unarchive, delete, and restore documents, including nested hierarchies
Search and Navigation: Search by keywords, list collections, view document structures, and retrieve document IDs from titles
Export Functions: Export documents or collections in markdown, JSON, or HTML format
Comment Management: View, add, and retrieve comments on documents with pagination support
Collection Management: Create, update, delete, and organize collections containing documents
Relationship Tools: View backlinks (documents that link to a specific document)
AI Integration: Query document content using natural language questions
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Outline Server search for documents about quarterly planning"
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.
MCP Outline Server
📢 Official Outline MCP Server Available
Outline now ships an official MCP server — we recommend using it. Read the docs.
A Model Context Protocol server for interacting with Outline document management.
Related MCP server: Coda MCP Server
Features
Document operations: Search, read, create, edit, archive documents
Collections: List, create, manage document hierarchies
Comments: Add and view threaded comments
Backlinks: Find documents referencing a specific document
MCP Resources: Direct content access via URIs (outline://document/{id}, outline://collection/{id}, etc.)
Automatic rate limiting: Transparent handling of API limits with retry logic
Prerequisites
Before using this MCP server, you need:
An Outline account (cloud hosted or self-hosted)
API key from Outline web UI: Settings → API Keys → Create New
Python 3.10+ (for non-Docker installations)
Getting your API key: Log into Outline → Click your profile → Settings → API Keys → "New API Key". Copy the generated token.
Quick Start
One-Click Install
Click a button to install with interactive API key prompt:
Manual Install
Install with uv (recommended), pip, or Docker:
uvx mcp-outline # using uv
pip install mcp-outline # using pip# using Docker
docker run -e OUTLINE_API_KEY=<your-key> ghcr.io/vortiago/mcp-outline:latestThen add to your MCP client config (works with VS Code, Claude Desktop, Cursor, and others):
{
"inputs": [
{
"id": "outline_api_key",
"type": "promptString",
"description": "Enter OUTLINE_API_KEY",
"password": true
},
{
"id": "outline_api_url",
"type": "promptString",
"description": "Outline API URL (optional, for self-hosted)",
"password": false
}
],
"servers": {
"mcp-outline": {
"command": "uvx",
"args": ["mcp-outline"],
"env": {
"OUTLINE_API_KEY": "${input:outline_api_key}",
"OUTLINE_API_URL": "${input:outline_api_url}"
}
}
}
}claude mcp add mcp-outline uvx mcp-outlineInstalling the repo as a plugin instead also bundles the
outline-explorer agent (fast read-only wiki exploration) and the
outline skill (Outline conventions: mermaidjs fences, document
structure, editing workflows).
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"mcp-outline": {
"command": "uvx",
"args": ["mcp-outline"],
"env": {
"OUTLINE_API_KEY": "<YOUR_API_KEY>",
"OUTLINE_API_URL": "<YOUR_OUTLINE_URL>"
}
}
}
}Setup guides for more clients: Docker (HTTP), Cline, Codex, Windsurf, and others
Configuration
Variable | Required | Default | Notes |
| Yes* | - | Required for tool calls to succeed. For SSE/HTTP, can alternatively be provided per-request via |
| No |
| For self-hosted: |
| No |
| Set |
| No |
|
|
| No |
|
|
| No |
|
|
| No |
|
|
| No |
|
|
| No |
| Max concurrent connections in pool |
| No |
| Max idle connections in pool |
| No |
| Read timeout in seconds |
| No |
| Connection timeout in seconds |
| No |
| Write timeout in seconds |
| No |
| Document cache TTL in seconds. The short default absorbs same-task read bursts without stressing the Outline API; set |
| No |
| Max cached documents |
| No |
| Transport mode: |
| No |
| Server host. Use |
| No |
| HTTP server port (only for |
Access Control
Feature | Env Var | Effect |
Read-only mode |
| Disables all write operations — only search, read, and export tools available |
Disable deletes |
| Disables only delete operations, all other writes allowed |
Disable recent-changes tool |
| Disables only the |
Dynamic tool list |
| Filters tools per-user based on Outline role and API key scopes |
Per-user Outline API keys |
| Each user passes their own Outline API key in HTTP mode for multi-user setups |
Read-only mode takes precedence over disable-delete. See Configuration Guide for details.
Tools
Note: Tool availability depends on your access control settings.
Search & Discovery
search_documents(query, collection_id?, limit?, offset?, statusFilter?)- Search documents by keywords with pagination. Defaults to published documents; passstatusFilterwithdraft,archived, and/orpublishedto include other stateslist_recently_updated_documents(date_filter?, collection_id?, status_filter?, limit?, offset?)- List documents by most recent change, newest first (e.g. "what changed this week").date_filterwindows by last change:day/week/month/year(defaultweek). Defaults to published documentslist_collections()- List all collectionsget_collection_structure(collection_id)- Get document hierarchy within a collectionget_document_id_from_title(query, collection_id?)- Find document ID by title search
Document Reading
read_document(document_id, offset?, limit?)- Get document content with optional line-range paginationexport_document(document_id)- Export document as markdown
Document Navigation
get_document_toc(document_id)- Get table of contents with heading structure and line numbersread_document_section(document_id, heading)- Read a specific section by heading match (case-insensitive substring)
Document Management
create_document(title, collection_id, text?, parent_document_id?, publish?)- Create new documentupdate_document(document_id, title?, text?, append?)- Replace full document content (append mode available)
Document Editing
edit_document(document_id, edits, save?)- String-match editing with batched replacements;save=Falsestages changes locally,save=Trueon the final call pushes all changesmove_document(document_id, collection_id?, parent_document_id?)- Move document to different collection or parent
Document Lifecycle
archive_document(document_id)- Archive documentunarchive_document(document_id)- Restore document from archivedelete_document(document_id, permanent?)- Delete document (or move to trash)restore_document(document_id)- Restore document from trashlist_archived_documents()- List all archived documentslist_trash()- List all documents in trash
Comments & Collaboration
add_comment(document_id, text, parent_comment_id?)- Add comment to document (supports threaded replies)list_document_comments(document_id, include_anchor_text?, limit?, offset?)- View document comments with paginationget_comment(comment_id, include_anchor_text?)- Get specific comment detailsget_document_backlinks(document_id)- Find documents that link to this document
Collection Management
create_collection(name, description?, color?)- Create new collectionupdate_collection(collection_id, name?, description?, color?)- Update collection propertiesdelete_collection(collection_id)- Delete collectionexport_collection(collection_id, format?)- Export collection (default: outline-markdown)export_all_collections(format?)- Export all collections
Batch Operations
batch_create_documents(documents)- Create multiple documents at oncebatch_update_documents(updates)- Update multiple documents at oncebatch_move_documents(document_ids, collection_id?, parent_document_id?)- Move multiple documentsbatch_archive_documents(document_ids)- Archive multiple documentsbatch_delete_documents(document_ids, permanent?)- Delete multiple documents
AI-Powered
ask_ai_about_documents(question, collection_id?, document_id?)- Ask natural language questions about your documents
Resources
outline://collection/{id}- Collection metadata (name, description, color, document count)outline://collection/{id}/tree- Hierarchical document tree structureoutline://collection/{id}/documents- Flat list of documents in collectionoutline://document/{id}- Full document content (markdown)outline://document/{id}/backlinks- Documents that link to this document
Development
git clone https://github.com/Vortiago/mcp-outline.git
cd mcp-outline
uv sync --group dev
uv run poe test-unit # unit tests
uv run poe test-integration # integration tests (starts MCP server via stdio)
uv run poe test-e2e # E2E tests (requires Docker)See Development Guide for self-hosted Outline setup, MCP Inspector, and more.
Troubleshooting
Server not connecting? Test your API key:
curl -H "Authorization: Bearer YOUR_API_KEY" YOUR_OUTLINE_URL/api/auth.infoSee Troubleshooting Guide for common issues with tools, rate limiting, and Docker.
Contributing
Contributions welcome! See CONTRIBUTING.md for setup instructions.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
Built with MCP Python SDK
Uses Outline API for document management
Available Tools
38 toolsadd_commentA
Adds a comment to a document or replies to an
existing comment.
Use this tool when you need to:
- Provide feedback on document content
- Ask questions about specific information
- Reply to another user's comment
- Collaborate with others on document development
Args:
document_id: The document to comment on
text: The comment text (supports markdown)
parent_comment_id: Optional parent comment ID
(for replies)
Returns:
Result message with the new comment ID
Inputs: text (required), document_id (required), parent_comment_id. Returns: result
archive_documentADestructiveIdempotent
Archives a document to remove it from active use while preserving it.
IMPORTANT: Archived documents are removed from collections but remain
searchable in the system. They won't appear in normal collection views
but can still be found through search or the archive list.
Use this tool when you need to:
- Remove outdated or inactive documents from view
- Clean up collections while preserving document history
- Preserve documents that are no longer relevant
- Temporarily hide documents without deleting them
Args:
document_id: The document ID to archive
Returns:
Result message confirming archival
Inputs: document_id (required). Returns: result
ask_ai_about_documentsARead-only
Queries document content using natural language questions.
Use this tool when you need to:
- Find specific information across multiple documents
- Get direct answers to questions about document content
- Extract insights from your knowledge base
- Answer questions like "What is our vacation policy?"
- Answer "How do we onboard new clients?" and similar queries
Args:
question: The natural language question to ask
collection_id: Optional collection to limit the search to
document_id: Optional document to limit the search to
Returns:
AI-generated answer based on document content with sources
Inputs: question (required), document_id, collection_id. Returns: result
batch_archive_documentsADestructiveIdempotent
Archives multiple documents in a single batch operation.
This tool processes each document sequentially, continuing even if
individual operations fail. Rate limiting is handled automatically
by the Outline client.
IMPORTANT: Archived documents are removed from collections but remain
searchable. They won't appear in normal collection views but can
still be found through search or the archive list.
Use this tool when you need to:
- Archive multiple outdated documents at once
- Clean up collections in bulk
- Batch hide documents without deleting them
Recommended batch size: 10-50 documents per operation
Args:
document_ids: List of document IDs to archive
Returns:
Summary of batch operation with success/failure details
Inputs: document_ids (required). Returns: result
batch_create_documentsADestructiveIdempotent
Creates multiple documents in a single batch
operation.
This tool processes each creation sequentially,
continuing even if individual operations fail.
Rate limiting is handled automatically.
Use this tool when you need to:
- Create multiple documents at once
- Bulk import content into collections
- Set up document structures efficiently
Note: For Mermaid diagrams, use ```mermaidjs
(not ```mermaid) as the code fence language
identifier for proper rendering.
Recommended batch size: 10-50 documents per
operation
Args:
documents: List of document specifications
Returns:
Summary of batch operation with created
document IDs and success/failure details
Inputs: documents (required). Returns: result
batch_delete_documentsADestructiveIdempotent
Deletes multiple documents, moving them to trash or permanently.
This tool processes each document sequentially, continuing even if
individual operations fail. Rate limiting is handled automatically.
IMPORTANT: When permanent=False (the default), documents are moved
to trash and retained for 30 days. Setting permanent=True bypasses
trash and immediately deletes documents without recovery option.
Use this tool when you need to:
- Remove multiple unwanted documents at once
- Clean up workspace in bulk
- Permanently delete sensitive information (with permanent=True)
Recommended batch size: 10-50 documents per operation
Args:
document_ids: List of document IDs to delete
permanent: If True, permanently deletes without recovery option
Returns:
Summary of batch operation with success/failure details
Inputs: document_ids (required), permanent. Returns: result
batch_move_documentsADestructiveIdempotent
Moves multiple documents to a different collection or parent.
This tool processes each document sequentially, continuing even if
individual operations fail. Rate limiting is handled automatically.
IMPORTANT: When moving documents that have child documents, all
children will move along with them, maintaining hierarchical
structure. You must specify either collection_id or
parent_document_id (or both).
Use this tool when you need to:
- Reorganize multiple documents at once
- Move documents between collections in bulk
- Restructure document hierarchies efficiently
Recommended batch size: 10-50 documents per operation
Args:
document_ids: List of document IDs to move
collection_id: Target collection ID (optional)
parent_document_id: Target parent document ID (optional)
Returns:
Summary of batch operation with success/failure details
Inputs: document_ids (required), collection_id, parent_document_id. Returns: result
batch_update_documentsADestructiveIdempotent
Updates multiple documents with different changes.
This tool processes each update sequentially,
continuing even if individual operations fail.
Rate limiting is handled automatically.
Use this tool when you need to:
- Update multiple documents with different changes
- Batch edit document titles or content
- Append content to multiple documents
Note: For Mermaid diagrams, use ```mermaidjs
(not ```mermaid) as the code fence language
identifier for proper rendering.
Recommended batch size: 10-50 documents per
operation
Args:
updates: List of update specifications
Returns:
Summary of batch operation with
success/failure details
Inputs: updates (required). Returns: result
create_collectionA
Creates a new collection for organizing documents.
Use this tool when you need to:
- Create a new section or category for documents
- Set up a workspace for a new project or team
- Organize content by department or topic
- Establish a separate space for related documents
Args:
name: Name for the collection
description: Optional description of the collection's
purpose
color: Optional hex color code for visual
identification (e.g. #FF0000)
Returns:
Result message with the new collection ID
Inputs: name (required), color, description. Returns: result
create_documentA
Creates a new document in a specified collection.
Use this tool when you need to:
- Add new content to a knowledge base
- Create documentation, guides, or notes
- Add a child document to an existing parent
- Start a new document thread or topic
- Create a reusable template document
Note: For Mermaid diagrams, use ```mermaidjs
(not ```mermaid) as the code fence language
identifier for proper rendering.
Args:
title: The document title
collection_id: The collection ID to create in
text: Optional markdown content for the document
parent_document_id: Optional parent document ID
for nesting
publish: Whether to publish immediately (True)
or save as draft (False)
template: If True, creates the document as a
template
icon: Optional emoji character to use as the
document icon (e.g. "📋", "🚀"). If None,
no icon is set.
Returns:
Result message with the new document ID
Inputs: title (required), collection_id (required), icon, text, +3 more. Returns: result
delete_collectionADestructiveIdempotent
Permanently removes a collection and all its documents.
Use this tool when you need to:
- Remove an entire section of content
- Delete obsolete project collections
- Remove collections that are no longer needed
- Clean up workspace organization
WARNING: This action cannot be undone and will delete all
documents within the collection.
Args:
collection_id: The collection ID to delete
Returns:
Result message confirming deletion
Inputs: collection_id (required). Returns: result
delete_documentADestructiveIdempotent
Moves a document to trash or permanently deletes it.
IMPORTANT: When permanent=False (the default), documents are
moved to trash and retained for 30 days before being
permanently deleted. During this period, they can be restored
using the restore_document tool. Setting permanent=True
bypasses the trash and immediately deletes the document
without any recovery option.
Use this tool when you need to:
- Remove unwanted or unnecessary documents
- Delete obsolete content
- Clean up workspace by removing documents
- Permanently remove sensitive information (with permanent=True)
Args:
document_id: The document ID to delete
permanent: If True, permanently deletes the document without
recovery option
Returns:
Result message confirming deletion
Inputs: document_id (required), permanent. Returns: result
edit_documentADestructive
Edits a document using string-match replacement.
Each edit finds a unique old_string in the document
and replaces it with new_string. Edits are applied
server-side — you never need to hold the full
document in context.
IMPORTANT: Batch all edits for a document into a
single call when possible to minimize API calls.
Each old_string must uniquely match one location in
the document. Include surrounding context if needed
to disambiguate.
Edits are applied sequentially, so later edits can
target text created by earlier edits in the same
batch. If any edit fails, no changes are applied
(all-or-nothing).
By default (save=True), changes are pushed to
Outline immediately. Set save=False to stage changes
locally for large rewrites spanning multiple calls,
then pass save=True on the final call to push all
accumulated changes.
Args:
document_id: The document ID to edit
edits: List of edits to apply
save: If True (default), push changes to Outline
immediately. If False, stage locally.
Returns:
Summary of edits applied and save status
Inputs: edits (required), document_id (required), save. Returns: result
export_all_collectionsARead-onlyIdempotent
Exports the entire workspace content to a downloadable file.
IMPORTANT: This tool starts an asynchronous export operation which may
take time to complete, especially for large workspaces. The function
returns information about the operation, including its status. When
the operation is complete, the file can be downloaded or accessed via
Outline's UI. The export includes all collections, documents, and
their
hierarchies in the specified format.
Use this tool when you need to:
- Create a complete backup of all workspace content
- Migrate content to another system
- Archive all workspace documents
- Get a comprehensive export of knowledge base
Args:
format: Export format ("outline-markdown", "json", or "html")
Returns:
Information about the export operation and how to access the file
Inputs: format. Returns: result
export_collectionARead-onlyIdempotent
Exports all documents in a collection to a downloadable file.
IMPORTANT: This tool starts an asynchronous export operation which may
take time to complete. The function returns information about the
operation, including its status. When the operation is complete, the
file can be downloaded or accessed via Outline's UI. The export
preserves the document hierarchy and includes all document content and
structure in the
specified format.
Use this tool when you need to:
- Create a backup of collection content
- Share collection content outside of Outline
- Convert collection content to other formats
- Archive collection content for offline use
Args:
collection_id: The collection ID to export
format: Export format ("outline-markdown", "json", or "html")
Returns:
Information about the export operation and how to access the file
Inputs: collection_id (required), format. Returns: result
export_documentARead-onlyIdempotent
Exports a document as plain markdown text.
Use this tool when you need to:
- Get clean markdown content without formatting
- Extract document content for external use
- Process document content in another application
- Share document content outside Outline
Args:
document_id: The document ID to export
Returns:
Document content in markdown format without
additional formatting
Inputs: document_id (required). Returns: result
fetch_attachmentARead-onlyIdempotent
Fetch attachment content and return it as base64.
Calls attachments.redirect, follows the redirect, and returns the
raw file content encoded as base64. Useful for images and files
that agents can process.
Use this tool when you need to:
- Read PDF content from Outline documents
- Process embedded images
- Analyze files referenced in documents
- Enable AI tools to work with all document content
Args:
attachment_id: The attachment UUID
Returns:
Multi-line string in this format (blank line after Content-Length
/ before Content-Base64):
Content-Type: <mime-type>
Content-Length: <bytes>
Content-Base64: <base64-encoded-data>
Note: For large files (e.g. multi-MB PDFs), the base64 output
may hit token limits. Prefer get_attachment_url to obtain a
download URL for large attachments, then fetch externally.
Inputs: attachment_id (required). Returns: result
get_attachment_urlARead-onlyIdempotent
Resolve an attachment ID to a downloadable URL.
Calls attachments.redirect and returns the final URL after the
redirect. Allows clients/agents to fetch the file themselves.
Use this tool when you need to:
- Get a direct URL to download an attachment
- Share or reference an attachment URL
- Let another system fetch the file
Args:
attachment_id: The attachment UUID
Returns:
The redirect URL (signed download URL)
Inputs: attachment_id (required). Returns: result
get_collection_structureARead-onlyIdempotent
Retrieves the hierarchical document structure of a collection.
Use this tool when you need to:
- Understand how documents are organized in a collection
- Find document IDs within a specific collection
- See the parent-child relationships between documents
- Get an overview of a collection's content structure
Args:
collection_id: The collection ID to examine
Returns:
Formatted string showing the hierarchical structure of documents
Inputs: collection_id (required). Returns: result
get_commentARead-onlyIdempotent
Retrieves a specific comment by its ID.
Use this tool when you need to:
- View details of a specific comment
- Reference or quote a particular comment
- Check comment content and metadata
- Find a comment mentioned elsewhere
Args:
comment_id: The comment ID to retrieve
include_anchor_text: Whether to include the document text that
the comment refers to
Returns:
Formatted string with the comment content and metadata
Inputs: comment_id (required), include_anchor_text. Returns: result
get_document_backlinksARead-onlyIdempotent
Finds all documents that link to a specific document.
Use this tool when you need to:
- Discover references to a document across the workspace
- Identify dependencies between documents
- Find documents related to a specific document
- Understand document relationships and connections
Args:
document_id: The document ID to find backlinks for
Returns:
Formatted string listing all documents that link to
the specified document
Inputs: document_id (required). Returns: result
get_document_id_from_titleARead-onlyIdempotent
Locates a document ID by searching for its title.
IMPORTANT: This tool first checks for exact title matches
(case-insensitive). If none are found, it returns the best partial
match instead. This is useful when you're not sure of the exact title
but need
to reference a document in other operations. Results are more accurate
when you provide more of the actual title in your query.
Use this tool when you need to:
- Find a document's ID when you only know its title
- Get the document ID for use in other operations
- Verify if a document with a specific title exists
- Find the best matching document if exact title is unknown
Args:
query: Title to search for (can be exact or partial)
collection_id: Optional collection to limit the search to
Returns:
Document ID if found, or best match information
Inputs: query (required), collection_id. Returns: result
get_document_tocARead-onlyIdempotent
Returns the heading structure of a document as a
table of contents with line numbers.
Use this tool when you need to:
- Understand the structure of a large document
- Find specific sections before reading them
- Navigate a document by its headings
Line numbers in the output can be used with
read_document(offset=...) or
read_document_section(heading=...) to read specific
parts.
Args:
document_id: The document ID
Returns:
Formatted table of contents with line numbers
Inputs: document_id (required). Returns: result
list_archived_documentsARead-onlyIdempotent
Displays all documents that have been archived.
Use this tool when you need to:
- Find specific archived documents
- Review what documents have been archived
- Identify documents for possible unarchiving
- Check archive status of workspace content
Returns:
Formatted string containing list of archived documents
Inputs: no named parameters. Returns: result
list_collectionsARead-onlyIdempotent
Retrieves and displays all available collections in the workspace.
Use this tool when you need to:
- See what collections exist in the workspace
- Get collection IDs for other operations
- Explore the organization of the knowledge base
- Find a specific collection by name
Args:
limit: Maximum number of results to return
offset: Number of results to skip (pagination)
Returns:
Formatted string containing collection names, IDs, and descriptions
If the response contains as many collections as the
limit, execute the tool again with an increased offset
to check for more results.
Inputs: limit, offset. Returns: result
list_document_attachmentsARead-onlyIdempotent
List attachment IDs referenced in a document.
Parses document content for attachment references (e.g.
/api/attachments.redirect?id=<uuid>) and returns a list of
attachment IDs with context snippets.
Use this tool when you need to:
- Discover attachments within a document
- Find attachment IDs for use with get_attachment_url or
fetch_attachment
- Audit what files a document references
Args:
document_id: The document ID to scan
Returns:
Formatted list of attachment IDs and context
Inputs: document_id (required). Returns: result
list_document_commentsARead-onlyIdempotent
Retrieves comments on a specific document with pagination support.
IMPORTANT: By default, this returns up to 25 comments at a time. If
there are more than 25 comments on the document, you'll need to make
multiple calls with different offset values to get all comments. The
response will indicate if there
are more comments available.
Use this tool when you need to:
- Review feedback and discussions on a document
- See all comments from different users
- Find specific comments or questions
- Track collaboration and input on documents
Args:
document_id: The document ID to get comments from
include_anchor_text: Whether to include the document text that
comments refer to
limit: Maximum number of comments to return (default: 25)
offset: Number of comments to skip for pagination (default: 0)
Returns:
Formatted string containing comments with author, date, and
optional anchor text
Inputs: document_id (required), limit, offset, include_anchor_text. Returns: result
list_recently_updated_documentsARead-onlyIdempotent
Lists documents ordered by most recent change (newest first).
Answers questions like "what changed this week" without needing
search keywords. Backed by Outline's search endpoint with an empty
query, sorted by last-modified time.
IMPORTANT: date_filter is a coarse server-side window on each
document's last-modified time. It accepts only "day", "week",
"month", or "year" (no arbitrary timestamps) and defaults to
"week". Results are ordered newest-changed first.
STATUS FILTER: By default this lists published documents only.
Pass status_filter to include other states. Allowed values are
"draft", "archived", and "published". Drafts only ever include
those you are allowed to see.
PAGINATION: Returns up to limit documents (default 25). Use offset
to page through older changes.
Use this tool when you need to:
- Answer "what documents changed recently / this week"
- Review recent activity, optionally within one collection
- Catch up on edits since you last looked
Args:
date_filter: Time window on last-modified time. One of "day",
"week", "month", "year". Defaults to "week".
collection_id: Optional collection to limit results to
status_filter: Optional list of statuses to include. Allowed
values are "draft", "archived", and "published". Defaults
to published only.
limit: Maximum number of documents to return (default: 25)
offset: Number of documents to skip for pagination (default: 0)
Returns:
Formatted string listing documents with their IDs and
last-updated timestamps, newest first
Inputs: limit, offset, date_filter, collection_id, +1 more. Returns: result
list_trashARead-onlyIdempotent
Displays all documents currently in the trash.
Use this tool when you need to:
- Find deleted documents that can be restored
- Review what documents are pending permanent deletion
- Identify documents to restore from trash
- Verify if specific documents were deleted
Returns:
Formatted string containing list of documents in trash
Inputs: no named parameters. Returns: result
move_documentADestructive
Relocates a document to a different collection or parent document.
IMPORTANT: When moving a document that has child documents (nested
documents), all child documents will move along with it, maintaining
their hierarchical structure. You must specify either collection_id or
parent_document_id (or both).
Use this tool when you need to:
- Reorganize your document hierarchy
- Move a document to a more relevant collection
- Change a document's parent document
- Restructure content organization
Args:
document_id: The document ID to move
collection_id: Target collection ID (if moving between collections)
parent_document_id: Optional parent document ID (for nesting)
Returns:
Result message confirming the move operation
Inputs: document_id (required), collection_id, parent_document_id. Returns: result
read_documentARead-onlyIdempotent
Retrieves and displays document content, optionally
paginated by line range.
Use this tool when you need to:
- Access the complete content of a specific document
- Read a specific range of lines from a large
document
- Review document information in detail
- Quote or reference document content
When offset or limit are set, output includes line
numbers and a metadata header showing the range.
When both are 0 (default), the full document is
returned in the original format for backward
compatibility.
Args:
document_id: The document ID to retrieve
offset: 0-based line number to start from;
must be non-negative (default: 0)
limit: Number of lines to return; 0 means all
lines; must be non-negative (default: 0)
Returns:
Formatted string containing the document title
and content
Inputs: document_id (required), limit, offset. Returns: result
read_document_sectionARead-onlyIdempotent
Reads a specific section of a document identified by
heading match.
Uses case-insensitive substring matching against
headings. Returns the section content from the matched
heading up to the next heading of the same or higher
level, including all nested subsections.
Use this tool when you need to:
- Read a specific part of a large document
- Focus on one section without loading everything
- Navigate by heading name instead of line numbers
Args:
document_id: The document ID
heading: Case-insensitive substring to match
against headings (e.g. "arch" matches
"## Architecture")
Returns:
Section content with line numbers
Inputs: heading (required), document_id (required). Returns: result
restore_documentAIdempotent
Recovers a document from the trash back to active status.
Use this tool when you need to:
- Retrieve accidentally deleted documents
- Restore documents from trash to active use
- Recover documents deleted within the last 30 days
- Access content that was previously trashed
Args:
document_id: The document ID to restore
Returns:
Result message confirming restoration
Inputs: document_id (required). Returns: result
search_document_contentARead-onlyIdempotent
Searches within a document for lines containing a
text snippet (grep-style), returning matches with
line numbers and surrounding context.
Use this tool when you need to:
- Locate specific text in a large document without
reading it in full
- Find the exact text and line number to build
edit_document old_string values or
read_document offsets
Matching is case-insensitive per line. Line numbers
are 0-based and valid as read_document offsets.
Args:
document_id: The document ID to search
query: Text snippet to find (case-insensitive)
context_lines: Lines of context around each
match (default: 2, must be non-negative)
Returns:
Matching lines with line numbers and context
Inputs: query (required), document_id (required), context_lines. Returns: result
search_documentsARead-onlyIdempotent
Searches for documents using keywords or phrases across your knowledge
base.
IMPORTANT: The search performs full-text search across all document
content and titles. Results are ranked by relevance, with exact
matches
and title matches typically ranked higher. The search will return
snippets of content (context) where the search terms appear in the
document. You can limit the search to a specific collection by
providing
the collection_id.
PAGINATION: By default, returns up to 25 results at a time. If more
results exist, use the 'offset' parameter to fetch additional pages.
For example, use offset=25 to get results 26-50, offset=50 for
51-75, etc.
STATUS FILTER: By default, searches published documents only. Pass
status_filter to include other document states. Allowed values are
"draft", "archived", and "published".
Use this tool when you need to:
- Find documents containing specific terms or topics
- Locate information across multiple documents
- Search within a specific collection using collection_id
- Discover content based on keywords
- Browse through large result sets using limit and offset
Args:
query: Search terms (e.g., "vacation policy" or "project plan")
collection_id: Optional collection to limit the search to
limit: Maximum results to return (default: 25, max: 100)
offset: Number of results to skip for pagination (default: 0)
status_filter: Optional list of statuses to search. Allowed values
are "draft", "archived", and "published". Defaults to
["published"] when omitted.
Returns:
Formatted string containing search results with document titles,
contexts, and pagination information
Inputs: query (required), limit, offset, collection_id, +1 more. Returns: result
unarchive_documentAIdempotent
Restores a previously archived document to active status.
Use this tool when you need to:
- Restore archived documents to active use
- Access or reference previously archived content
- Make archived content visible in collections again
- Update and reuse archived documents
Args:
document_id: The document ID to unarchive
Returns:
Result message confirming restoration
Inputs: document_id (required). Returns: result
update_collectionADestructive
Modifies an existing collection's properties.
Use this tool when you need to:
- Rename a collection
- Update a collection's description
- Change a collection's color coding
- Refresh collection metadata
Args:
collection_id: The collection ID to update
name: Optional new name for the collection
description: Optional new description
color: Optional new hex color code (e.g. #FF0000)
Returns:
Result message confirming update
Inputs: collection_id (required), name, color, description. Returns: result
update_documentADestructive
Modifies an existing document's title or content.
IMPORTANT: This tool replaces the document content
rather than just adding to it. For partial edits
(changing specific text), prefer the edit_document
tool instead.
Use this tool when you need to:
- Replace the entire document content
- Change a document's title
- Append new content to an existing document
- Convert a document to or from a template
Note: For Mermaid diagrams, use ```mermaidjs
(not ```mermaid) as the code fence language
identifier for proper rendering.
Args:
document_id: The document ID to update
title: New title (if None, keeps existing title)
text: New content (if None, keeps existing)
append: If True, adds text to end of document
instead of replacing
template: If True, converts to a template.
If False, converts a template back to a
regular document.
icon: Optional emoji character to use as the
document icon (e.g. "📋", "🚀"). If None,
keeps existing icon. Pass an empty string
to remove the icon.
Returns:
Result message confirming update
Inputs: document_id (required), icon, text, title, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 38 tools
Each tool targets a distinct resource and action. Document tools (create, read, update, edit, delete, archive, restore, move, search, comment) and collection tools (CRUD, export, structure) are clearly separated. Even similar tools like edit_document (string replacement) and update_document (full content replacement) have well-defined distinct purposes.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_document, archive_document, batch_delete_documents). There are no deviations or mixed conventions, making it easy for an agent to predict tool names.
38 tools is slightly above typical range but well-justified for a full document management system. Tools cover CRUD, batch operations, search, navigation, attachments, comments, export, and lifecycle management. No obvious bloat, though reducing some batch variants could be considered.
Comprehensive coverage of document and collection lifecycle: create, read (multiple variants), update, delete, archive, unarchive, restore, move, search, export. Also includes comments, attachments, backlinks, and table of contents. No significant gaps for document management tasks.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
The Telnyx MCP server is an official implementation of the Model Context Protocol that enables AI clients (like Claude Desktop, Cursor, and OpenAI Agents) to interact with Telnyx's telephony, messaging, and AI assistant APIs. It provides comprehensive capabilities including making and managing phone calls, sending SMS/MMS messages, purchasing and configuring phone numbers, creating AI assistants with custom instructions, managing cloud storage buckets, scraping and embedding website content, and handling integration secrets. The server exists as both a local implementation and a remotely hosted version, allowing developers to integrate real-world communication infrastructure directly into AI applications.
Related MCP Servers
- AlicenseAqualityDmaintenanceA Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.121MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables AI assistants to interact with Coda documents, allowing operations like listing, creating, reading, updating, and duplicating pages.19884 npm62MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol server for interacting with Outline document management, supporting search, read, create, edit, archive documents, collections, comments, and backlinks.30MIT
- AlicenseNot gradedqualityFmaintenanceA Model Context Protocol server that enables AI agents to manage documents, collections, comments, and users in Outline through its API.671 npm121MIT