Plain MCP

Read and manage Plain support threads, customers, tenants, broadcasts, help-center content, Sidekick sessions, and workspace settings through Plain's hosted MCP server.

80 actionsAPI key

Connect Plain MCP

What your bot can do in Plain MCP

Looks up

  • GetbroadcastaudiencedetailsFetch a single broadcast audience by its ID, or null if no audience with that ID exists.
  • GetbroadcastaudiencesFetch a paginated list of the workspace's broadcast audiences, newest first.
  • GetbroadcastdetailsFetch a single broadcast by its ID, including its authored content and who it is targeted at.
  • GetbroadcastsFetch a paginated list of the workspace's broadcasts, newest first.
  • GetbroadcastsenddeliveriesFetch the individual recipients of one broadcast send — which channel got the message, which did not, and why.
  • GetbroadcastsendsFetch the send history of one broadcast, newest first.
  • GetcustomerdetailsFetch detailed information about a specific customer by their ID.
  • GetcustomersFetch a paginated list of customers from Plain.
  • GetcustomerthreadsFetch first 10 threads for a specific customer.
  • GethelpcenterarticleFetch detailed information for a specific help-center article by ID.
Show 24 more
  • GethelpcenterarticlebyslugFetch detailed information for a specific help-center article by slug.
  • GethelpcenterarticlegroupsFetch a paginated list of article groups for a specific help center.
  • GethelpcenterarticlesFetch a paginated list of articles for a specific help center.
  • GethelpcentersFetch a paginated list of help centers.
  • GetlabelsFetch a paginated list of label types from Plain.
  • GetmyassignedthreadsFetch first 10 threads assigned to a specific user in Plain.
  • GetmyuserGet the currently authenticated user's details.
  • GetmyworkspaceGet the currently authenticated user's workspace details.
  • GetsidekicksessionPoll a Sidekick session.
  • GetsnippetFetch a single snippet by ID, including soft-deleted snippets (where isDeleted is true).
  • GetsnippetsFetch a paginated list of snippets from the workspace.
  • GettenantdetailsFetch detailed information about a specific tenant by their ID.
  • GettenantsFetch a paginated list of tenants from Plain.
  • GetthreaddetailsFetch complete details for a specific thread including first 50 timeline entries.
  • GetthreadfieldschemasFetch a paginated list of thread field schemas from Plain.
  • GetthreadknowledgesourcecitationsFetch the knowledge sources cited by AI agent replies on a thread.
  • GetthreadsFetch threads with flexible filtering options.
  • GetuserbyemailLook up a Plain user by their email address.
  • ListsidekicksessionsList Sidekick sessions in the workspace, most recent activity first.
  • SearchbroadcastsSearch broadcasts by name.
  • SearchcustomersSearch for customers by name, email, short name, or external ID.
  • SearchtenantsSearch for tenants by name or external ID.
  • SearchthreadlinkcandidatesSearch a connected issue tracker for external entities that can be linked to a thread via createThreadLink.
  • SearchthreadsSearch threads by text content in title, description, or messages.

Takes action

  • AddgeneratedreplyAdd an AI-generated reply suggestion to a thread.
  • AddlabelsAdd labels to a thread by label type IDs.
  • ArchivelabeltypeArchive a label type to hide it from the active label list.
  • AssignthreadAssign a thread to a user or machine user.
  • BulkupsertthreadfieldsBulk upsert (create or update) multiple thread field values in a single operation.
  • ChangethreadpriorityChange the priority of a thread.
  • CreatebroadcastCreate a new broadcast.
  • CreatebroadcastaudienceCreate a reusable broadcast audience.
  • CreatelabeltypeCreate a new label type for organizing threads.
  • CreatenoteCreate an internal note on a thread.
Show 36 more
  • CreatesnippetCreate a new snippet (reusable reply template) in the workspace.
  • CreatethreadCreate a new thread for a customer.
  • CreatethreadfieldschemaCreate a new thread field schema to capture structured data on threads.
  • CreatethreadlinkLink a thread to an external entity (e.g.
  • CreateworkspaceslackintegrationfromauthConnect workspace Slack notifications using a Slack connection the workspace already has.
  • DeletebroadcastSoft-delete a broadcast.
  • DeletebroadcastaudienceSoft-delete a broadcast audience.
  • DeletethreadfieldschemaDelete a thread field schema from the workspace.
  • DeletethreadlinkRemove a link between a thread and an external entity.
  • GetattachmentdownloadurlGenerate a short-lived download URL for an attachment on a thread.
  • MarkcustomerasspamFlag a customer as spam.
  • MarkthreadasdoneMark a thread as done (resolved).
  • MarkthreadastodoMark a thread as todo (reopen or set as active).
  • MergethreadMerge one Plain thread into another (a MERGED_INTO native thread link).
  • MovelabeltypeMove a label type to a different position in the label hierarchy.
  • RemovelabelsRemove labels from a thread by label IDs.
  • ReorderthreadfieldschemasReorder multiple thread field schemas in a single operation.
  • ReplytothreadReply to the last message in a thread.
  • ResolvesidekickapprovalApprove or deny a Sidekick tool-call approval request.
  • SendsidekickmessageSend a follow-up message into an existing Sidekick session.
  • SendtestbroadcastSend a test copy of a broadcast to Slack channels you name, so you can see what recipients will get before the real audience does.
  • SnoozethreadSnooze a thread for a specified duration.
  • StartsidekicksessionStart a new Sidekick session and return the handle used by every other Sidekick tool.
  • UnarchivelabeltypeUnarchive a previously archived label type to make it available again.
  • UnassignthreadUnassign a thread, removing the current assignee.
  • UnmarkcustomerasspamClear the spam flag from a customer, restoring their threads to the inbox and metrics.
  • UpdatebroadcastUpdate one or more fields of an existing broadcast.
  • UpdatebroadcastaudienceUpdate a broadcast audience's name, filters, or both.
  • UpdatelabeltypeUpdate an existing label type's properties.
  • UpdatethreadfieldschemaUpdate an existing thread field schema's properties.
  • UpdatethreadtitleUpdate the title (subject line) of an existing thread.
  • UpsertcustomerCreate or update a customer.
  • UpserthelpcenterarticleCreate or update a help-center article.
  • UpserttenantCreate or update a tenant.
  • UpserttenantfieldCreate or update a tenant field.
  • UpsertthreadfieldUpsert (create or update) a thread field value on a thread.

More communication apps