Outline MCP Server

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

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-Len…

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)

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

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

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

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 docum…

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

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

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.

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

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 …

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…

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

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 betwe…

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 …

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 "## Architect…

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

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…

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 of…

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

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

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…