Integration · Documents

Connect Claude & ChatGPT to Outline

Ask your AI to find the page that explains a process, sum up a document, or write a new one in your Outline wiki. It can search and read documents, look at edit history, create and update pages, add comments and move pages between collections. Your team's knowledge becomes something you can ask questions about.

Connect Outline free

Free plan, no credit card. Takes about a minute.

Try asking

“Where do we describe our onboarding process?”
The AI runs a full-text search across the wiki and shows the matching documents with text snippets.
“Summarize the Security policy page.”
It finds the document by title, reads its full Markdown text and gives you a short summary.
“Write a draft page in Engineering called Release checklist.”
It creates the document in the Engineering collection with Markdown text. It stays a draft until you publish it.

What your AI can do

Search and read

Full-text and title search, full document text, child pages, collection trees, drafts and recently viewed documents.

Write and organize

Create documents from scratch or from templates, update, publish, move, duplicate, archive and restore pages, and manage collections.

Comments and history

Read, add, edit and resolve comments, and look at a document's revisions or roll it back to an earlier one.

“What changed in the pricing page this week?”
It lists the document's revisions and reads the text of earlier versions so it can compare them.
“Reply to the open comments on the Q3 plan.”
It lists the comments on the document, adds replies in the threads and can mark a thread as resolved.
“Show me the page tree of the Handbook collection.”
It gets the collection's full structure with all nested pages.

154 tools for Outline

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_a_collection_userChanges dataCreate a new category. Required: id or user id. API summary: Add a collection user.
add_a_document_userChanges dataCreate a new document. Required: id or user id. Search documents first to avoid duplicates. API summary: Add a document user.
add_a_group_memberChanges dataCreate a new group. Required: id or user id. API summary: Add a group member.
add_a_group_to_a_collectionChanges dataCreate a new category. Required: id or group id. API summary: Add a group to a collection.
add_a_group_to_a_documentChanges dataCreate a new document. Required: id or group id. Search documents first to avoid duplicates. API summary: Add a group to a document.
add_a_reaction_to_a_commentChanges dataCreate a new message. Required: id or emoji. API summary: Add a reaction to a comment.
approve_access_requestVisible to othersApprove a access request. Has effects visible outside this system. API summary: Approve an access request.
archive_categoryVisible to othersArchive a category. Has effects visible outside this system. API summary: Archive a collection.
archive_documentVisible to othersArchive a document by `id` so it is hidden from the main navigation. It can be brought back with restore_document.
create_a_subscriptionChanges dataCreate a new subscription. Required: event. API summary: Create a subscription.
create_a_webhook_subscriptionDeletesCreate a new subscription. Required: name, url or events. Destructive action; may require approval. API summary: Create a webhook subscription.
create_access_requestChanges dataCreate a new access request. Required: document id. API summary: Create an access request.
create_access_requests_dismissChanges dataCreate a new access requests dismiss. Required: id. API summary: Dismiss an access request.
create_an_attachment_from_a_urlChanges dataCreate a new document. Required: url. Search documents first to avoid duplicates. API summary: Create an attachment from a URL.
create_api_keyChanges dataCreate a new api key. Required: name. API summary: Create an API key.
create_attachments_redirectChanges dataCreate a new attachments redirect. Required: id. API summary: Retrieve an attachment.
create_auth_configChanges dataCreate a new auth config. API summary: Retrieve auth config.
create_collectionChanges dataCreate a new collection with `name`, optional `description`, `icon`, `color` and default `permission` (read or read_write) for the team.
create_collections_moveChanges dataCreate a new collections move. Required: id or index. API summary: Move a collection.
create_commentChanges dataAdd a comment to a document by `document_id` with Markdown `text`; pass `parent_comment_id` to reply in a thread. Mentioned people may be notified.
create_comments_unresolveChanges dataCreate a new comments unresolve. Required: id. API summary: Unresolve a comment.
create_customerChanges dataCreate a new customer. Required: name or redirect uris. API summary: Create an OAuth client.
create_data_attributeChanges dataCreate a new data attribute. Required: name or data type. API summary: Create a data attribute.
create_documentChanges dataCreate a document with `title` and Markdown `text` in a `collection_id` (or under a `parent_document_id`). Set `publish` true to make it visible to the team; otherwise it stays a draft. Can start from a `template_id`.
create_document_2Changes dataCreate a new document. Required: name, content type or size. Search documents first to avoid duplicates. API summary: Create an attachment.
create_documents_answer_questionChanges dataCreate a new documents answer question. API summary: Query documents with natural language.
create_documents_deletedChanges dataCreate a new documents deleted. API summary: List all deleted documents.
create_documents_empty_trashChanges dataCreate a new documents empty trash.
create_documents_insightChanges dataCreate a new documents insight. Required: id. API summary: Retrieve insights for a document.
create_documents_templatizeChanges dataCreate a new documents templatize. Required: id or publish. API summary: Create a template from a document.
create_file_operations_redirectChanges dataCreate a new file operations redirect. Required: id. API summary: Retrieve the file.
create_groupChanges dataCreate a new group. Required: name. API summary: Create a group.
create_oauth_clients_rotate_secretChanges dataCreate a new oauth clients rotate secret. Required: id. API summary: Rotate the secret for an OAuth client.
create_pinChanges dataCreate a new pin. Required: document id. API summary: Pin a document.
create_shareChanges dataCreate a new share. API summary: Create a share.
create_shares_revokeChanges dataCreate a new shares revoke. Required: id. API summary: Revoke a share.
create_starChanges dataCreate a new star. API summary: Create a star.
create_subscriptionChanges dataCreate a new subscription. Required: id. API summary: List all collection memberships.
create_templateChanges dataCreate a new template. API summary: Create a template.
create_userChanges dataCreate a new user. Required: id. API summary: List document users.
create_users_inviteVisible to othersCreate a new users invite. Required: invites. Has effects visible outside this system. API summary: Invite users.
create_users_notifications_subscribeChanges dataCreate a new users notifications subscribe. API summary: Subscribe to a notification type.
create_users_notifications_unsubscribeChanges dataCreate a new users notifications unsubscribe. API summary: Unsubscribe from a notification type.
create_users_suspendChanges dataCreate a new users suspend. Required: id. API summary: Suspend a user.
delete_a_collectionDeletesPermanently delete a category. Destructive action; may require approval. API summary: Delete a collection.
delete_a_webhook_subscriptionDeletesPermanently delete a subscription. Destructive action; may require approval. API summary: Delete a webhook subscription.
delete_api_keysDeletesPermanently delete a api key. Destructive action; may require approval. API summary: Delete an API key.
delete_authsDeletesPermanently delete a auth. Destructive action; may require approval. API summary: Sign out.
delete_categoriesDeletesPermanently delete a category. Destructive action; may require approval. API summary: Remove a collection user.
delete_customersDeletesPermanently delete a customer. Destructive action; may require approval. API summary: Delete an OAuth client.
delete_data_attributesDeletesPermanently delete a data attribute. Destructive action; may require approval.
delete_documentDeletesMove a document by `id` to the trash. With `permanent` true it is deleted for good and cannot be recovered.
delete_documentsDeletesPermanently delete a document. Destructive action; may require approval. API summary: Delete an attachment.
delete_file_operationsDeletesPermanently delete a file operation. Destructive action; may require approval.
delete_groupsDeletesPermanently delete a group. Destructive action; may require approval.
delete_messagesDeletesPermanently delete a message. Destructive action; may require approval. API summary: Delete a comment.
delete_oauth_authenticationsDeletesPermanently delete a oauth authentication. Destructive action; may require approval. API summary: Delete an OAuth authentiation.
delete_pinsDeletesPermanently delete a pin. Destructive action; may require approval.
delete_revisionsDeletesPermanently delete a revision. Destructive action; may require approval.
delete_starsDeletesPermanently delete a star. Destructive action; may require approval.
delete_subscriptionsDeletesPermanently delete a subscription. Destructive action; may require approval.
delete_templatesDeletesPermanently delete a template. Destructive action; may require approval.
delete_usersDeletesPermanently delete a user. Destructive action; may require approval.
duplicate_documentVisible to othersMake a copy of a document by `id`, optionally with a new `title`, target `collection_id` or `parent_document_id`, and `recursive` to copy child pages too.
export_all_collectionsChanges dataExport categories. API summary: Export all collections.
export_categoriesChanges dataExport categories. API summary: Export a collection.
export_documentsChanges dataExport documents. API summary: Export a document.
export_revisionsChanges dataExport revisions. API summary: Export a revision.
get_collectionChanges dataGet one collection by `id`, with its name, description and permissions.
get_collection_structureChanges dataGet the full page tree (nested documents) of a collection by `id`.
get_data_attributeChanges dataGet one data attribute. API summary: Retrieve a data attribute.
get_documentChanges dataGet one document by `id` (or URL slug id), including its title and full Markdown text.
get_file_operationChanges dataGet one file operation. API summary: Retrieve a file operation.
get_groupChanges dataGet one group. API summary: Retrieve a group.
get_messageChanges dataGet one message. API summary: Retrieve a comment.
get_pinChanges dataGet one pin. API summary: Retrieve a pin.
get_revisionChanges dataGet one revision by `id`, including the document's text at that point in time.
get_templateChanges dataGet one template. API summary: Retrieve a template.
get_userChanges dataGet one workspace member by `id`, with name, email and role.
list_access_requestsChanges dataList access requests. API summary: Retrieve an access request.
list_accessible_oauth_clientsChanges dataList customers. API summary: List accessible OAuth clients.
list_all_collection_group_membersChanges dataCreate a new subscription. Required: id. API summary: List all collection group members.
list_all_group_membersChanges dataCreate a new subscription. Required: id. API summary: List all group members.
list_all_sharesChanges dataList shares. API summary: List all shares.
list_all_webhook_subscriptionsDeletesList subscriptions. Destructive action; may require approval. API summary: List all webhook subscriptions.
list_api_keysChanges dataList api keys.
list_archived_documentsChanges dataList archived documents, optionally within one `collection_id`.
list_authsChanges dataList auths. API summary: Retrieve auth.
list_child_documentsChanges dataGet the nested pages under a document, by the parent document's `id`.
list_collectionsChanges dataList the collections (top-level sections of the wiki), optionally matching `query`.
list_commentsChanges dataList comments on a document (`document_id`) or across a collection (`collection_id`).
list_customersChanges dataList customers. API summary: Retrieve an OAuth client.
list_data_attributesChanges dataList data attributes. API summary: List all data attributes.
list_document_group_membershipsChanges dataCreate a new subscription. Required: id. API summary: List document group memberships.
list_document_membershipsChanges dataCreate a new subscription. Required: id. API summary: List document memberships.
list_document_revisionsChanges dataList the saved revisions (edit history) of a document by `document_id`.
list_documentsChanges dataList documents, optionally filtered by `collection_id`, `parent_document_id` or author `user_id`, with sort and paging.
list_documents_2Changes dataList documents. API summary: List all attachments.
list_draftsChanges dataList your unpublished draft documents, optionally filtered by `collection_id` or `date_filter`.
list_eventsChanges dataList events. API summary: List all events.
list_file_operationsChanges dataList file operations. API summary: List all file operations.
list_groupsChanges dataList groups. API summary: List all groups.
list_notificationsChanges dataList notifications.
list_oauth_authenticationsChanges dataList oauth authentications. API summary: List accessible OAuth authentications.
list_pinsChanges dataList pins.
list_reactionsChanges dataList reactions.
list_recently_viewed_documentsChanges dataList the documents you viewed most recently.
list_sharesChanges dataList shares. API summary: Retrieve a share object.
list_starsChanges dataList stars. API summary: List all stars.
list_subscriptionsChanges dataList subscriptions. API summary: List group memberships.
list_subscriptions_listChanges dataList subscriptions.
list_subscriptions_user_memberships_listChanges dataList subscriptions. API summary: List document memberships.
list_templatesChanges dataList document templates, optionally matching `query` or within a `collection_id`. Use a template's id as `template_id` when creating a document.
list_usersChanges dataList workspace members, optionally matching `query` (name or email), `emails` or `filter` (active, invited, suspended).
list_viewsChanges dataList views. API summary: List all views.
move_documentChanges dataMove a document by `id` to another `collection_id` and/or under a new `parent_document_id`.
remove_a_collection_groupDeletesPermanently delete a category. Destructive action; may require approval. API summary: Remove a collection group.
remove_a_document_userDeletesPermanently delete a document. Destructive action; may require approval. API summary: Remove a document user.
remove_a_group_from_a_documentDeletesPermanently delete a document. Destructive action; may require approval. API summary: Remove a group from a document.
remove_a_group_memberDeletesPermanently delete a group. Destructive action; may require approval. API summary: Remove a group member.
remove_a_reaction_from_a_commentDeletesPermanently delete a message. Destructive action; may require approval. API summary: Remove a reaction from a comment.
resolve_commentChanges dataMark a comment thread as resolved by the comment `id`.
restore_categoryChanges dataRestore a category. API summary: Restore an archived collection.
restore_documentChanges dataRestore an archived or deleted document by `id`, or roll it back to an earlier `revision_id`.
restore_templateChanges dataRestore a template.
retrieve_a_subscriptionChanges dataList subscriptions. API summary: Retrieve a subscription.
search_document_titlesChanges dataFind documents whose title matches `query`. Faster than full-text search when you know roughly what the page is called.
search_documentsChanges dataFull-text search across the wiki's documents with `query`, optionally narrowed by `collection_id`, author `user_id` or `date_filter` (day, week, month, year). Returns matching documents with text snippets.
submit_categoryVisible to othersDuplicate a category. Has effects visible outside this system. API summary: Duplicate a collection.
submit_documentVisible to othersUnpublish a document. Has effects visible outside this system.
submit_templateVisible to othersDuplicate a template. Has effects visible outside this system.
submit_userVisible to othersActivate a user. Has effects visible outside this system.
submit_user_resendVisible to othersResend a user. Has effects visible outside this system. API summary: Resend a user invite.
update_a_group_memberChanges dataUpdate an existing group. API summary: Update a group member.
update_a_user_s_emailVisible to othersUpdate an existing user. Has effects visible outside this system. API summary: Update a user's email.
update_a_webhook_subscriptionDeletesUpdate an existing subscription. Destructive action; may require approval. API summary: Update a webhook subscription.
update_all_notificationsChanges dataUpdate an existing notification. API summary: Update all notifications.
update_collectionChanges dataUpdate a collection's `name`, `description`, `icon`, `color` or default `permission` by `id`. Only the fields you pass change.
update_commentChanges dataEdit the `text` of a comment by `id`.
update_customersChanges dataUpdate an existing customer. API summary: Update an OAuth client.
update_data_attributesChanges dataUpdate an existing data attribute. API summary: Update a data attribute.
update_documentChanges dataUpdate a document's `title` or `text` by `id`. `edit_mode` chooses whether text replaces, appends or prepends; set `publish` true to publish a draft.
update_groupsChanges dataUpdate an existing group. API summary: Update a group.
update_notificationsChanges dataUpdate an existing notification. API summary: Update a notification.
update_pinsChanges dataUpdate an existing pin. API summary: Update a pin.
update_revisionsChanges dataUpdate an existing revision. API summary: Update a revision.
update_sharesChanges dataUpdate an existing share. API summary: Update a share.
update_starsChanges dataUpdate an existing star. API summary: Update a stars order in the sidebar.
update_subscriptionsChanges dataUpdate an existing subscription. API summary: Update a document membership.
update_templatesChanges dataUpdate an existing template. API summary: Update a template.
update_usersChanges dataUpdate an existing user. API summary: Update a user.
update_users_updateDeletesUpdate an existing user. Destructive action; may require approval. API summary: Change a users role.
upload_categoryChanges dataImport a category. API summary: Import documents into a new collection.
upload_documentChanges dataImport a document. API summary: Import a file as a document.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Outline from the app list.
2
Paste your key
Enter your Outline address without https:// (app.getoutline.com for Outline cloud, or your own domain if you host Outline yourself) and an API key. In Outline, open Settings › API & Apps and create a new API key. It starts with ol_api_. Treat it like a password.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Outline?

It can search and read documents, collections, templates, comments, revisions and workspace members. It can create and update documents and collections, publish drafts, move, duplicate, archive and restore documents, and add, edit and resolve comments. It can also move a document to the trash if you switch that tool on.

Does the AI see my Outline API key?

No. Your Outline API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with search and reading only. Deleting a document can be permanent, and it can require your approval before it runs, as can archiving or any other action you pick. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Outline account.

Does it work with self-hosted Outline?

Yes. When you connect, you enter the address of your Outline workspace. Use app.getoutline.com for Outline cloud, or your own domain if you host Outline yourself. The API key comes from Settings › API & Apps in that workspace.