Plain MCP integration
CRM and support connector, available on Zeplik
Plain MCP is available as an integration on Zeplik, the AI assistant that works across every model in one chat. Connect Plain MCP and Zeplik can act on your customer relationships and support for you: Read and manage Plain support threads, customers, tenants, broadcasts, help-center content, Sidekick sessions, and workspace settings through Plain's. You stay in the conversation while the assistant does the work in Plain MCP directly.
Zeplik exposes 35 read actions and 45 write actions for Plain MCP. Read actions run automatically; write actions stay off until you enable write access in Settings, so nothing is changed in Plain MCP without your consent.
Try Plain MCP on Zeplik
Pick a prompt to open it in the Zeplik app. If you are not signed in yet, your prompt is waiting for you the moment you do.
What Zeplik can do with Plain MCP
Read from Plain MCP (35)
Runs automatically in any conversation.
Get attachment download url
Generate a short-lived download URL for an attachment on a thread. Use attachment IDs returned by getThreadDetails (in the attachments field of timeline entries such as NoteEntry, ChatEntry, EmailEntry, SlackMessageEntry, etc.). The returned downloadUrl expires after 3 minutes — fetch the file promptly after calling this tool. If attachmentVirusScanResult is INFECTED or FAILED, do not download the file. A null attachmentVirusScanResult means virus scanning is not enabled for the workspace. Requires the attachment:download permission.
Get broadcast audience details
Fetch a single broadcast audience by its ID, or null if no audience with that ID exists. Returns soft-deleted audiences (where `isDeleted` is true), so the record of what a past broadcast was sent to survives. In `filters`, dimensions on one node AND together and values within a dimension OR. `slackChannels` are channels pinned by ID; the `slackChannelNameContains` substrings are re-resolved at send time. An audience with no filters at all means every tenant. `type` is fixed at creation and must match the type of any broadcast the audience is attached to. Audience IDs start with `ba_`. Do not invent IDs — only use values returned by the MCP tools.
Get broadcast audiences
Fetch a paginated list of the workspace's broadcast audiences, newest first. An audience is a named, reusable set of broadcast recipients, resolved to concrete Slack channels at send time rather than when it was saved. Soft-deleted audiences are excluded. Pass `searchQuery` to narrow to audiences whose name contains it, matched case-insensitively and unanchored. The match happens in the database, so it finds audiences that are not on the current page. Use the `cursor` variable with the endCursor from the previous response's pageInfo to fetch the next page. The cursor is an opaque token: pass it back unchanged and do not construct, modify, or alter it. Set `first` to control page size (default 50). In `filters`, dimensions on one node AND together and values within a dimension OR: `tierIds: [a, b]` means either tier, while `tierIds: [a]` plus `slackChannelNameContains: ["eng"]` means both must hold. `slackChannels` are channels pinned by ID, so an audience holding only those is a saved channel list. `slackChannelNameContains` is re-resolved at send time, so it picks up channels created or renamed since. An audience with no filters at all means every tenant. An audience's own filters never contain `audienceIds` — an audience cannot be defined in terms of another one. Audience IDs start with `ba_`. Do not invent IDs — only use values returned by the MCP tools.
Get broadcast details
Fetch a single broadcast by its ID, including its authored content and who it is targeted at. Returns null if no broadcast with that ID exists, and returns soft-deleted broadcasts (where `isDeleted` is true). `content` is encoded as `contentFormat` says: `TIPTAP` is a serialised Tiptap JSON document (what the Plain app writes); `SLACK_BLOCK_KIT` is a JSON array of Slack blocks. Neither is plain text or markdown. `sendTarget` is who the broadcast reaches, resolved to concrete channels at send time rather than now. `scope: ALL_TENANTS` means every tenant with a connected channel and carries no `filters`; `scope: MATCHING` means only what `filters` selects. `recipients` are channels named outright and added to whatever `filters` resolves to; `excludeRecipients` are subtracted last. Inside `filters`, dimensions on one node AND together and values within a dimension OR. `audienceIds` reference saved audiences — read them with `getBroadcastAudienceDetails`. `latestSend` is the most recent non-test send, and where progress lives. Use `getBroadcastSends` for the full send history, and `getBroadcastSendDeliveries` for the recipients of one send. Broadcast IDs start with `bc_`, audience IDs with `ba_`. Broadcast URL format: https://app.plain.com/workspace/{workspaceId}/broadcasts/{broadcastId} where {workspaceId} is fetched via `getMyWorkspace` (starts with `w_`). Do not invent IDs — only use values returned by the MCP tools.
Get broadcast send deliveries
Fetch the individual recipients of one broadcast send — which channel got the message, which did not, and why. Use this to answer "who missed it" or "did this channel get it". A delivery is one recipient's copy of the broadcast within one send. Narrow with `deliveryStatuses`, e.g. ["FAILED"] or ["SENT"], and read `failureReason` for why a delivery did not land. Combine with `searchQuery` to find one recipient: matched case-insensitively and unanchored against the recorded Slack channel name, the Slack channel id, and the email address, so a delivery is found by whichever of those identifies it. The match happens in the database, so it finds deliveries that are not on the current page. Omit `searchQuery` rather than passing an empty string. `slackChannelName` is the name recorded when the send resolved, so it still names a channel that was later renamed or disconnected; it is null for deliveries from before the name was recorded. This reads the send named by `broadcastSendId`. Get the id from `getBroadcastSends`; use `isTest` to distinguish test from real sends there. An id belonging to another broadcast matches nothing. `cursor` and `first` page that send's deliveries. Use the endCursor from the previous response's `deliveries.pageInfo`; it stays valid because every page selects the same send. The cursor is an opaque token: pass it back unchanged and do not construct, modify, or alter it. `deliveryCounts` on the send is the unfiltered summary of the whole send. `deliveries.totalCount` is how many rows match `deliveryStatuses` and `searchQuery`. A broadcast with hundreds of recipients has hundreds of deliveries, so prefer the counts plus a `deliveryStatuses: ["FAILED"]` query over paging the whole list. `edges` is empty when the broadcast has no send with that id. For the full send history use `getBroadcastSends`. Broadcast IDs start with `bc_`, send IDs with `bcs_`, delivery IDs with `bcsd_`. Do not invent IDs — only use values returned by the MCP tools.
Get broadcast sends
Fetch the send history of one broadcast, newest first. Use this to answer "has this broadcast gone out, and how far did each run get". One send is one run of the broadcast. A broadcast that has been sent once and tested twice has three sends. Test sends post real messages and collect real deliveries, so check `isTest` before presenting an entry as a real send, or pass `isTest: false` to exclude them. `statuses` narrows to sends in particular states; `DRAFT` is not one of them, since it describes a broadcast with no send rather than a send. Omit a filter to leave that dimension unconstrained — an empty list is rejected. `deliveryCounts` is how far a send got, summarised across its recipients. It is one query per send regardless of how many recipients there are, so read it rather than counting recipients. For the individual recipients of one send — which channel got it, which failed and why — use `getBroadcastSendDeliveries`. Use the `cursor` variable with the endCursor from the previous response's pageInfo to fetch the next page. The cursor is an opaque token: pass it back unchanged and do not construct, modify, or alter it. Set `first` to control page size (default 20). Broadcast IDs start with `bc_`, send IDs with `bcs_`. Do not invent IDs — only use values returned by the MCP tools.
Get broadcasts
Fetch a paginated list of the workspace's broadcasts, newest first. A broadcast is a message authored once and posted to many Slack channels at once. Soft-deleted broadcasts are excluded from this list. Optionally narrow the list with `statuses`, e.g. ["DRAFT"] for broadcasts still being written or ["SENT"] for ones already delivered. A broadcast's status comes from its latest real send, so no status reflects a test send. Omit `statuses` to list every status — an empty list is rejected. Use the `cursor` variable with the endCursor from the previous response's pageInfo to fetch the next page. The cursor is an opaque token: pass it back unchanged and do not construct, modify, or alter it. Set `first` to control page size (default 50). `latestSend` is the most recent non-test send and is where progress lives — read `deliveryCounts` from it rather than counting deliveries. Use `getBroadcastSends` for a broadcast's full send history, and `getBroadcastSendDeliveries` for the recipients of one send. Broadcast IDs start with `bc_`. Broadcast URL format: https://app.plain.com/workspace/{workspaceId}/broadcasts/{broadcastId} where {workspaceId} is fetched via `getMyWorkspace` (starts with `w_`). Do not invent IDs — only use values returned by the MCP tools.
Get customer details
Fetch detailed information about a specific customer by their ID. Returns the customer's profile including email, avatar, assignment, company, and timestamps.
Get customer threads
Fetch first 10 threads for a specific customer. Use this to see a customer's full support history. Optionally filter by status or sort by different criteria. Use the `cursor` variable with the endCursor from the previous response's pageInfo to fetch the next page. The cursor is an opaque token: pass it back unchanged and do not construct, modify, or alter it. Set `first` to control page size (default 10). Thread URL format: https://app.plain.com/workspace/{workspaceId}/thread/{threadId}/ where {threadId} is the thread `id` field on each result (starts with `th_`) and {workspaceId} is fetched via `getMyWorkspace` (starts with `w_`). Do not invent IDs — only use values returned by the MCP tools.
Get customers
Fetch a paginated list of customers from Plain. Results are sorted by full name and exclude customers marked as spam. Use the `cursor` variable with the endCursor from the previous response's pageInfo to fetch the next page. The cursor is an opaque token: pass it back unchanged and do not construct, modify, or alter it. Set `first` to control page size (default 50). tenantIdentifiers filters by current tenant membership (not the tenant stamped on a thread). Call `getTenants` or `searchTenants` first to discover tenant `id` (starts with `te_`) and `externalId`. Each entry must set exactly one of `tenantId` or `externalId`; omit the unused field or set it to null. Multiple entries are combined with OR. Example: tenantIdentifiers: [{ tenantId: "te_01..." }] tenantIdentifiers: [{ tenantId: "te_01...", externalId: null }] tenantIdentifiers: [{ externalId: "acme-prod" }] To list threads for those customers, pass the returned customer `id` values to `getThreads` as `customerIds`.
Get help center article
Fetch detailed information for a specific help-center article by ID. Help-center article URL format (Plain dashboard): https://app.plain.com/workspace/{workspaceId}/help-center/{helpCenterId}/articles/{helpCenterArticleId}/ where {helpCenterArticleId} is the article `id` returned by this query (starts with `hca_`). This query does not return the parent help center, so {helpCenterId} (starts with `hc_`) must come from the caller's prior context or from `getHelpCenters`. {workspaceId} (starts with `w_`) is fetched via `getMyWorkspace`. Do not invent IDs — only use values returned by the MCP tools.
Get help center article by slug
Fetch detailed information for a specific help-center article by slug. Help-center article URL format (Plain dashboard): https://app.plain.com/workspace/{workspaceId}/help-center/{helpCenterId}/articles/{helpCenterArticleId}/ where {helpCenterId} is the `$helpCenterId` argument passed to this query (starts with `hc_`), {helpCenterArticleId} is the article `id` returned by this query (starts with `hca_`), and {workspaceId} is fetched via `getMyWorkspace` (starts with `w_`). Do not invent IDs — only use values returned by the MCP tools.
and 23 more.
Act in Plain MCP (45)
Runs only after you enable write access.
Add generated reply
Add an AI-generated reply suggestion to a thread. Required fields: - threadId: The ID of the thread to add the generated reply to. - timelineEntryId: The ID of the timeline entry to associate the reply with. - markdown: The markdown content of the generated reply.
Add labels
Add labels to a thread by label type IDs. Labels are used to categorize and organize threads.
Archive label type
Archive a label type to hide it from the active label list. Archived label types are no longer available for selection but existing labels remain on threads. Use this to deprecate label types without losing historical data.
Assign thread
Assign a thread to a user or machine user. Provide either userId or machineUserId, not both. If neither is provided, the thread will be assigned to the authenticated user.
Bulk upsert thread fields
Bulk upsert (create or update) multiple thread field values in a single operation. Provide an array of thread field inputs, each with thread ID, field key, field type, and value. Use this to efficiently set multiple custom fields on one or more threads.
Change thread priority
Change the priority of a thread. Priority is an integer: 0 = urgent, 1 = high, 2 = normal, 3 = low.
Create broadcast
Create a new broadcast: a message authored once and posted to many Slack channels at once. Creating one never sends it — a new broadcast is a DRAFT, and scheduling the real send is done by a human in the Plain app. Required input fields: `name`, `content`, `contentFormat`, `type`. - `name` identifies the broadcast internally and is never shown to recipients. It is what `searchBroadcasts` matches on. - `notificationTitle` is what recipients see in the notification the broadcast arrives as. It does leave Plain. Optional here, but the broadcast cannot be sent or tested until it is set. - `type` must be `SLACK`. It is fixed at creation: content is written against a channel's rendering rules, so a broadcast cannot be moved to another channel later. - `contentFormat` and `content` go together. From MCP, send `SLACK_BLOCK_KIT` and a JSON array of Slack blocks, as `chat.postMessage` would take. A one-paragraph body looks like this, passed as a string: "[{\"type\":\"section\",\"text\":{\"type\":\"mrkdwn\",\"text\":\"Hello\"}}]" Buttons need a `url` — interactive elements do nothing in a broadcast. Images must be publicly reachable. This format cannot be edited in the Plain app. `TIPTAP` is still accepted (a serialised Tiptap document) and is what the app composer writes; do not use it unless you are copying content already stored that way. - `isLinkUnfurlingEnabled` controls whether Slack expands links and media. Defaults to true, which is Slack's own behaviour. - `senderType` is who the broadcast is sent as: `PLAIN_WORKSPACE` posts under the workspace's own name and logo and takes no `senderUserId`; `PLAIN_USER` posts as a Plain user and requires `senderUserId`. Get user IDs from `getMyUser` or `getUserByEmail`. Leave `senderEmailAddress` unset: it belongs to a future email channel, not to a Slack broadcast. - `sendTarget` is who the broadcast reaches, resolved to concrete channels at send time. `scope: ALL_TENANTS` means every tenant with a connected channel and rejects `filters`; `scope: MATCHING` requires `filters`. Omit `scope` to target only the channels named in `recipients`. Inside `filters`, dimensions AND together and values within a dimension OR, and it must constrain something — reaching everyone is `ALL_TENANTS`, not an empty filter. `audienceIds` reference saved audiences (`getBroadcastAudiences`), which must be of the same type as the broadcast. Both the sender and the target can be left unset here and filled in later with `updateBroadcast`. Use `sendTestBroadcast` to post a test copy to channels you name before a human schedules the real send.
Create broadcast audience
Create a reusable broadcast audience: a named set of broadcast recipients, resolved to concrete Slack channels at send time rather than when saved. Required input fields: `name`, `type`, `filters`. - `name` identifies the audience internally and is never shown to recipients. - `type` must be `SLACK`. It is fixed at creation, and an audience can only be attached to a broadcast of the same type. - `filters` is what the audience selects. Dimensions on one node AND together and values within a dimension OR: `tierIds: [a, b]` means either tier, while `tierIds: [a]` plus `slackChannelNameContains: ["eng"]` means both must hold. An empty dimension cannot be written — omit it instead. - `tenantIds` / `tierIds` — get IDs from `getTenants` or `searchTenants`. - `tenantFields` — filter on a tenant field by its `externalFieldId`, supplying the value field matching the field's type. - `slackChannels` — channels pinned by ID, nothing re-resolves these, so an audience holding only these is a saved channel list. - `slackChannelNameContains` — unanchored, case-insensitive name substrings, ORed with each other and resolved at send time, so channels created or renamed later are picked up. - `and` / `or` / `not` hold further filters. `and` and `or` nest at most two levels deep. `not` may name a single dimension and nothing else. - `audienceIds` is rejected here: an audience cannot be defined in terms of another audience. It is only valid on a broadcast's own send target. - `filters: {}` — no rows at all — means every tenant, and is the only way to say so. Every nested node must constrain something. `filters` is validated against `type`, so a filter naming a dimension this type cannot resolve is rejected here rather than silently resolving to nobody at send time. Editing an audience later changes who every broadcast using it will reach on its next send.
Create label type
Create a new label type for organizing threads. Label types can be single-select or multi-select, and can be hierarchical with parent label types. Use this to add new labels to your workspace's label taxonomy.
Create note
Create an internal note on a thread. Notes are visible to support agents only, not to customers. Requires a customerId and text content. Optionally provide a threadId to attach the note to a specific thread, and markdown for rich formatting.
Create snippet
Create a new snippet (reusable reply template) in the workspace. `name` is what agents search for when inserting the snippet. `text` is the plain-text body (required). Optionally provide `markdown` for rich-text channels, and `path` (alphanumeric only) to place the snippet in a folder in the Plain app. Snippet bodies may include template variables that Plain interpolates when the snippet is inserted, for example: {{ customer.email }}, {{ customer.fullName }}, {{ customer.shortName }}, {{ user.publicName }}, {{ user.fullName }}, {{ thread.ref }}, {{ thread.id }}
Create thread
Create a new thread for a customer. A thread is the unit of conversation in Plain. Use this when you need to open a new ticket on behalf of a customer (for example, capturing an internal report or a back-channel conversation). To send a message to the customer after creation, use `replyToThread`. To attach an internal note, use `createNote`. Required fields on `input`: - customerIdentifier: One of `customerId` (e.g. `c_...`), `externalId`, or `emailAddress`. The customer must already exist — call `upsertCustomer` first if it doesn't. Common optional fields: - title: Short summary of the thread. Defaults to `Support request` if omitted. - description: Preview text shown in thread lists. Inferred from message content when omitted (which only happens if you also send a first message). - priority: Integer 0–3, where 0 is most urgent and 3 is least urgent. Defaults to 2 (normal). Anything outside 0–3 is rejected. - assignedTo: Provide exactly one of `userId` or `machineUserId`. - labelTypeIds: Array of label type IDs (e.g. `lt_...`). Look these up via `getLabels` first; unknown IDs return a validation error. - threadFields: Each entry needs a `key` and `type` that match an existing thread field schema (see `getThreadFieldSchemas`). The schema must exist before you can attach a value. - tenantIdentifier: Provide either `tenantId` or `externalId` for an existing tenant. Unknown tenants return a validation error. - externalId: Your own unique identifier for this thread. Must be unique per workspace. - channel: One of `API` (default), `EMAIL`, `CHAT`, `INTERNAL`, `SLACK`, or `MS_TEAMS`. The schema also exposes `DISCORD` and `IMPORT`, but they are not accepted here — don't use them. - channelDetails: REQUIRED when `channel` is `SLACK` (provide `channelDetails.slack.{slackChannelId, slackTeamId}`) or `MS_TEAMS` (provide `channelDetails.msTeams.{msTeamsChannelId, msTeamsTeamId}`). MUST be omitted for any other channel — passing it returns a validation error. Gotchas: - This mutation only creates the thread shell. It does NOT send a message to the customer. Follow up with `replyToThread` if a customer-visible message is needed. - The legacy `components` and `attachmentIds` input fields are deprecated and should not be set — use `replyToThread` (or chat mutations) afterwards instead. - SLACK threads created this way are linked to a Slack channel/team but no Slack message is posted until you reply. - `customerIdentifier.emailAddress` will not auto-create a customer; the mutation fails if no customer matches. Thread URL format: https://app.plain.com/workspace/{workspaceId}/thread/{threadId}/ where `{threadId}` is the `id` returned below (starts with `th_`) and `{workspaceId}` comes from `getMyWorkspace` (starts with `w_`). Do not invent IDs — only use values returned by the MCP tools.
and 33 more.
How to connect Plain MCP
Sign in to Zeplik
Create a free Zeplik account or sign in. New accounts start with free credits, so you can try Plain MCP immediately.
Connect Plain MCP
Open Settings and go to Connectors, then press Connect on Plain MCP. You can also connect from the Plain MCP page in the app.
Approve access to Plain MCP
Approve access on Plain MCP's secure consent screen. You are returned to Zeplik and can start giving instructions that use Plain MCP.
Frequently asked questions
- Can I use Plain MCP with Zeplik?
- Yes. Plain MCP is available as an integration on Zeplik. Connect it once and the AI assistant can work with your Plain MCP account inside any conversation.
- What can Zeplik do with Plain MCP?
- Once connected, Zeplik has 35 read and 45 write actions for Plain MCP. Read and manage Plain support threads, customers, tenants, broadcasts, help-center content, Sidekick sessions, and workspace settings through Plain's.
- How do I connect Plain MCP to Zeplik?
- You connect Plain MCP with a secure one-click sign-in (OAuth): press Connect in Settings under Connectors and approve access on Plain MCP's consent screen.
- Does Zeplik change things in Plain MCP without asking?
- No. Zeplik reads from Plain MCP by default. Any action that changes data in Plain MCP requires write access, which stays off until you enable it in Settings under Connectors.
- How much does connecting Plain MCP cost?
- Connecting Plain MCP is free. You only spend Zeplik credits when the assistant runs, and new accounts start with free credits.
Related crm and support integrations
- PredictLeadsPredictLeads provides company intelligence on hiring, technologies, financing, news, products, business connections, and other growth signals.
- ProductlaneProductlane is a customer support and feedback system designed for modern companies, built on Linear.
- ProspeoProspeo provides B2B person and company search, enrichment, and verified contact data through its REST API.
- QuickEnrichQuickEnrich provides employee and company search, contact discovery, and enrichment APIs for sales and go-to-market workflows.
- Re:amazeRe:amaze is a multi-channel customer support platform offering live chat, email, social messaging, and automated workflows.
- RepairShoprRepairShopr is a comprehensive repair shop management software designed to streamline operations, manage customer relationships, and enhance business.
More on Zeplik
Connect Plain MCP to your AI assistant
Every model, one chat. Bring Plain MCP into Zeplik and let the assistant do the work.