outline-mcp
User Guides

Tool Reference

Complete, use-case-oriented reference for tools and resource URIs.

This page groups tools by operational intent so you can choose the right API surface quickly.

Core workspace and documents

Use caseMain tools
Server runtime inspectionserver_info
Collection discovery and managementlist_collections, create_collection, update_collection, delete_collection
Document search and readingsearch_documents, read_document, export_document
Document writing and movementcreate_document, update_document, move_document, safe_update_document
Document lifecycledelete_document, archive_document, unarchive_document, restore_document, list_archived_documents, list_trash

Batch operations

Use caseMain tools
Create many documentsbatch_create_documents
Update many documentsbatch_update_documents
Move many documentsbatch_move_documents
Archive many documentsbatch_archive_documents
Delete many documentsbatch_delete_documents

Structure, references, and AI support

Use caseMain tools
Inspect collection treeget_collection_structure
Resolve doc ID from titleget_document_id_from_title
Find inbound linksget_document_backlinks
Ask Outline AI over docsask_ai_about_documents

Templates and collaboration

Use caseMain tools
Template workflowslist_templates, create_template_from_document, create_document_from_template
Comment workflowslist_comments, get_comment, create_comment, update_comment, delete_comment
Membership managementlist_document_users, list_document_memberships, list_document_group_memberships, add_document_user, remove_document_user, add_document_group, remove_document_group, list_collection_memberships, list_collection_group_memberships, add_collection_user, remove_collection_user, add_collection_group, remove_collection_group

Audit, export, and lease control

Use caseMain tools
Audit and revisionslist_events, list_revisions, get_revision
Export and artifact handlingexport_collection, export_all_collections, list_file_operations, get_file_operation, download_file_operation
Concurrent ownership controlacquire_document_lease, renew_document_lease, release_document_lease, get_active_document_lease

Resource URIs

These resources are useful when the model should read context directly by URI.

  • outline://collection/{collection_id}
  • outline://collection/{collection_id}/tree
  • outline://collection/{collection_id}/documents
  • outline://document/{document_id}
  • outline://document/{document_id}/backlinks

Practical guidance

  • Prefer read and structure tools first when planning a change.
  • Use lifecycle and batch tools only when ownership boundaries are clear.
  • Use lease plus safe_update_document together for multi-agent writes.