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
- Install dependencies:
bun install
-
Get your Plain.com API key from Settings → API Keys with full API permissions.
-
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"
}
}
}
}
- Restart Claude Code to load the MCP server.
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"
