Plain.com MCP Server

$bun install
README.md

Comprehensive access to the Plain.com API with over 70 tools

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

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

  2. 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"
      }
    }
  }
}
  1. 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)
`de

Tools (14)

list_help_centersList all help centers in the workspace
get_help_centerGet details of a specific help center
create_help_centerCreate a new help center
list_help_center_articlesList articles in a help center
get_help_center_articleGet a specific help center article by ID
upsert_help_center_articleCreate or update a help center article
generate_help_center_articleAuto-generate an article from a thread using AI
upsert_customerCreate or update a customer
search_customersSearch for customers by email
list_threadsList support threads with optional status filter
get_threadGet detailed thread info including conversation timeline
reply_to_threadReply to a thread (sent via original channel)
mark_thread_doneMark a thread as done/resolved
create_noteCreate an internal note on a thread

Environment Variables

PLAIN_API_KEYrequiredPlain.com API key from Settings -> API Keys

Configuration

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

Try it

→List all active support threads that are currently marked as TODO.
→Search for a customer with the email 'user@example.com' and show their recent thread history.
→Draft a reply to thread 'thread_123' thanking them for their feedback.
→Generate a help center article based on the resolution of thread 'thread_456'.
→Add an internal note to the current thread about the customer's technical setup.

Frequently Asked Questions

What are the key features of Plain.com MCP Server?

Comprehensive coverage of Plain.com API with 77 specialized tools.. Full management of Help Centers, including article generation and DNS verification.. Customer relationship management including group assignments and spam filtering.. Advanced thread handling with support for priorities, labels, and custom fields.. Internal collaboration tools like private notes and thread assignments..

What can I use Plain.com MCP Server for?

Support agents managing high volumes of threads directly from their AI workspace.. Content managers auto-generating documentation from resolved support interactions.. Operations teams automating customer group assignments and spam management.. Technical leads tracking support queue statistics and thread priorities in real-time..

How do I install Plain.com MCP Server?

Install Plain.com MCP Server by running: bun install

What MCP clients work with Plain.com MCP Server?

Plain.com MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Use Plain.com MCP Server with Conare

Manage MCP servers visually, upload persistent context, and never start from zero with Claude Code & Codex.

Try Free

Related MCP Servers

Feishu MCP Server
A remote MCP server for Feishu (Lark) with OAuth and Cloudflare Workers support
communication81 stars
Instagram MCP Server
AI-driven management of Instagram Business accounts via Graph API
communication79 stars
Outline MCP Server
Read and write documents through the Outline API
communication11 stars
Discord MCP Server
Comprehensive administrative control over Discord communities via MCP
communication6 stars
Slabby
MCP server for Slab knowledge base integration with AI coding agents
communication6 stars
DingTalk MCP Server
Enables Claude to interact with DingTalk workspaces to search for users.
communication5 stars