Skip to content
Plain Help Center home
Plain Help Center home

MCP Server

The Plain MCP server at https://mcp.plain.com/mcp provides AI tools access to your Plain workspace. You will authenticate it via the same account you use to access the web app, so it will have the same context as your user.

Setup

Claude Code

claude mcp add plain --transport http https://mcp.plain.com/mcp

Then, in Claude Code, run the /mcp command and select the plain MCP to authenticate.

Claude.ai

  1. Navigate to "Customize" → "Connectors"

  2. Click the ➕ icon, then choose "Add custom connector"

  3. Add a custom connector named "Plain" with the Remote MCP server URL https://mcp.plain.com/mcp

  4. Click the "Connect" button next to the newly created Plain connector to authenticate.

If you're on a Claude Team plan, you may need to reach out to your administrator to add this custom connector for you.

Cursor

You can add the Plain MCP to Cursor via your Cursor config at ~/.cursor/mcp.json

{
  "mcpServers": {
    "plain": {
      "url": "https://mcp.plain.com/mcp"
    }
  }
}

Then, navigate to "Cursor Settings" -> "Tools & MCP" and click "Connect" next to the Plain MCP to authenticate.

Available Tools

Your MCP client will be able to do all of the following via the Plain MCP Server:

  • Fetch My Assigned Threads: List threads assigned to a specific user (active by default).

  • Reply To Thread: Send a reply to a thread (email, Slack, or form-origin thread).

  • Add Labels: Add selected labels to a thread.

  • Assign Thread: Assign a thread to a user, machine user, or yourself.

  • Change Thread Priority: Set a thread priority (urgent, high, normal, or low).

  • Create Note: Add an internal agent-only note to a customer or thread.

  • Fetch Customer Details: Get full profile details for a specific customer.

  • Fetch Customers: List customers with pagination (excluding spam by default).

  • Fetch Customer Threads: List threads for a specific customer.

  • Fetch Labels: List all labels available for use with other queries.

  • Fetch My User: Get the currently authenticated user profile.

  • Fetch My Workspace: Get the currently authenticated workspace details.

  • Fetch Thread Details: Get full thread details plus timeline entries.

  • Fetch Threads: List threads with flexible filters and pagination.

  • Fetch User By Email: Find a Plain user by email address.

  • Mark Thread As Done: Mark a thread as resolved/done.

  • Mark Thread As Todo: Reopen or set a thread back to active/todo.

  • Search Customers: Search customers by name, email, or external ID.

  • Search Threads: Search threads by text with optional filters.

  • Snooze Thread: Snooze a thread until later with a reason/duration.

  • Unassign Thread: Remove the current assignee from a thread.

  • Fetch Tenants: List tenants with pagination.

  • Fetch Tenant Details: Get full details for a specific tenant, including tenant fields.

  • Search Tenants: Search tenants by name or external ID.

  • Upsert Tenant: Create a new tenant or update an existing one.

Help Center

  • Get Help Centers: List help centers with pagination so users can select a help-center ID.

  • Get Help Center Articles: List articles for a specific help center with pagination.

  • Get Help Center Article: Fetch full details for a specific help-center article by ID.

  • Get Help Center Article By Slug: Fetch full details for a specific help-center article by slug.

  • Upsert Help Center Article: Create a new help-center article or update an existing one.

Use case examples

  1. Create an incident brief in minutes: “Compile affected customers, first-seen timestamp, trend over time, and likely related changes; publish a Slack incident summary.”

    Faster cross-team incident coordination.

  2. Triage a spike automatically: “Find new threads about checkout errors in last 24h, group by root cause, link to related GitHub issues, and post priorities to Slack.”

    Fast, de-duplicated incident triage with clear next actions.

  3. Detect churn-risk accounts proactively: “Find accounts with rising thread volume + repeated unresolved issues; create follow-up tasks and notify owners.”

    Earlier intervention before escalations.

Powered by Plain