README.md

Plain.com MCP Server

An MCP server providing comprehensive access to the Plain.com API from Claude, with 77 tools covering support threads, customers, help centers, automation, and more.

Setup

1. Install dependencies:

bun install

2. Get your Plain.com API key from Settings → API Keys with full API permissions.

3. Add to your Claude Code config (~/.claude.json):

{
  "mcpServers": {
    "plain": {
      "command": "bun",
      "args": ["run", "/path/to/plain-mcp/src/index.ts"],
      "env": {
        "PLAIN_API_KEY": "your-api-key"
      }
    }
  }
}

4. Restart Claude Code to load the MCP server.

Available Tools (77)

Help Centers

Tool	Description
list_help_centers	List all help centers in the workspace
get_help_center	Get details of a specific help center
create_help_center	Create a new help center
update_help_center	Update an existing help center
delete_help_center	Delete a help center
update_help_center_custom_domain	Set a custom domain for a help center
verify_help_center_custom_domain	Verify DNS ownership of a custom domain

Help Center Articles

Tool	Description
list_help_center_articles	List articles in a help center
get_help_center_article	Get a specific help center article by ID
get_help_center_article_by_slug	Get a help center article by its URL slug
upsert_help_center_article	Create or update a help center article
delete_help_center_article	Delete a help center article
generate_help_center_article	Auto-generate an article from a thread using AI

Help Center Article Groups

Tool	Description
list_help_center_article_groups	List article groups (categories) in a help center
get_help_center_article_group	Get a specific article group by ID
create_help_center_article_group	Create a new article group (category)
update_help_center_article_group	Update an article group
delete_help_center_article_group	Delete an article group

Help Center Index

Tool	Description
get_help_center_index	Get the navigation index/structure of a help center
update_help_center_index	Update the navigation index/structure

Knowledge Sources

Tool	Description
create_knowledge_source	Create a knowledge source for AI to reference
delete_knowledge_source	Delete a knowledge source

Customers

Tool	Description
upsert_customer	Create or update a customer
delete_customer	Delete a customer
get_customer	Get detailed customer information by ID
search_customers	Search for customers by email
mark_customer_as_spam	Mark a customer as spam
unmark_customer_as_spam	Remove spam marking from a customer
create_customer_event	Create a custom event on a customer timeline

Customer Groups

Tool	Description
list_customer_groups	List all customer groups
create_customer_group	Create a new customer group
add_customer_to_groups	Add a customer to one or more groups
remove_customer_from_groups	Remove a customer from one or more groups

Threads

Tool	Description
list_threads	List support threads with optional status filter
get_thread	Get detailed thread info including conversation timeline
get_queue_stats	Get a quick overview of support queue counts
create_thread	Create a new support thread for a customer
update_thread_title	Update the title of a thread
delete_thread	Permanently delete a thread
assign_thread	Assign a thread to a user
unassign_thread	Remove assignment from a thread
change_thread_priority	Change the priority of a thread
create_thread_event	Create a custom event on a thread timeline

Thread Actions

Tool	Description
reply_to_thread	Reply to a thread (sent via original channel)
mark_thread_done	Mark a thread as done/resolved
mark_thread_todo	Mark a thread as todo (re-open it)
snooze_thread	Snooze a thread for a specified duration

Thread Labels

Tool	Description
list_label_types	List all available label types
create_label_type	Create a new label type
add_labels_to_thread	Add labels to a thread
remove_labels_from_thread	Remove labels from a thread

Thread Fields

Tool	Description
list_thread_field_schemas	List all custom thread field schemas
upsert_thread_field	Set a custom field value on a thread

Notes

Tool	Description
create_note	Create an internal note on a thread (not visible to customer)
delete_note	Delete an internal note from a thread

Communication

Tool	Description
send_email	Send a new email to a customer (starts a new thread)
send_chat	Send a chat message to a customer

Companies

Tool	Description
upsert_company	Create or update a company
delete_company	Delete a company

Tenants

Tool	Description
upsert_tenant	Create or update a tenant
delete_tenant	Delete a tenant

Snippets

Tool	Description
list_snippets	List all snippets (canned responses)
create_snippet	Create a new snippet
update_snippet	Update an existing snippet
delete_snippet	Delete a snippet

Webhooks

Tool	Description
list_webhooks	List all webhook targets
create_webhook	Create a new webhook target
update_webhook	Update a webhook target
delete_webhook	Delete a webhook target

Autoresponders

Tool	Description
list_autoresponders	List all autoresponders
create_autoresponder	Create a new autoresponder
delete_autoresponder	Delete an autoresponder

Tiers

Tool	Description
list_tiers	List all support tiers
create_tier	Create a new support tier
delete_tier	Delete a support tier

Workspace & Users

Tool	Description
get_workspace	Get current workspace information
list_users	List workspace users

Example Usage

Ask Claude:

• "Show me all todo threads"
• "Get the details of thread th_xxx"
• "How many threads need attention?"
• "Find customer john@example.com"
• "Reply to thread th_xxx saying we're looking into it"
• "Mark thread th_xxx as done"
• "Snooze thread th_xxx for 24 hours"
• "Add a note to thread th_xxx that this is a billing issue"
• "Create a new help center article about password resets"
• "List all snippets"
• "Assign thread th_xxx to user u_xxx"
• "Generate a help center article from thread th_xxx"