What are the requirements for Plain.com MCP Server?

Plain.com MCP Server requires the following environment variables: PLAIN_API_KEY (required). You'll also need a compatible MCP client like Claude Desktop or Claude Code.

Is Plain.com MCP Server free to use?

Yes, Plain.com MCP Server is open source and free to use. You can find the source code on GitHub.

What MCP clients support Plain.com MCP Server?

Plain.com MCP Server works with any MCP-compatible client including Claude Desktop (Anthropic's official desktop app), Claude Code (CLI tool), Cursor, and other editors with MCP support.

How do I configure Plain.com MCP Server?

Configure Plain.com MCP Server by adding it to your MCP client's config file. The setup block at the top of this page generates a ready-to-paste config for Claude Code, Cursor, Codex, Windsurf, and Claude Desktop.

MCP server/communication

Plain.com MCP Server

Q: What tools does Plain.com MCP Server provide?

list_help_centers: List all help centers in the workspace. upsert_customer: Create or update a customer. list_threads: List support threads with optional status filter. reply_to_thread: Reply to a thread (sent via original channel). create_note: Create an internal note on a thread (not visible to customer).

Q: How do I install Plain.com MCP Server?

Install Plain.com MCP Server by running: bun install

Comprehensive access to the Plain.com API for support and customer management.

★ 3 tellahq/plain-mcp ↗by tellahqupdated Aug 26, 2026

Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.

Prepare the server locally

Run this once before adding it to Claude Code.

bun install

Register it in Claude Code

claude mcp add -e "PLAIN_API_KEY=${PLAIN_API_KEY}" plain-mcp -- bun run /path/to/plain-mcp/src/index.ts

Replace any placeholder paths in the command with the real path on your machine.

Required:PLAIN_API_KEY

Make your agent remember this setup

plain-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.

npx conare@latest

Free · one command · indexes the sessions already on disk. Set up in the browser instead →

What it does

Manage support threads, including status updates, assignments, and priorities.
Full CRUD operations for help centers, articles, and article categories.
Customer management including searching, grouping, and spam marking.
AI-powered generation of help center articles directly from support threads.
Internal note-taking and custom event tracking on customer and thread timelines.

Tools 5

list_help_centersList all help centers in the workspace

upsert_customerCreate or update a customer

list_threadsList support threads with optional status filter

reply_to_threadReply to a thread (sent via original channel)

create_noteCreate an internal note on a thread (not visible to customer)

Environment Variables

PLAIN_API_KEYrequiredAPI key from Plain.com Settings with full API permissions

Try it

→List all open support threads that need attention.

→Create a new internal note on the latest thread from the customer with email [email protected].

→Generate a help center article based on the conversation in the current thread.

→Search for the customer with email [email protected] and get their detailed information.

→Mark the current support thread as done.

Original README from tellahq/plain-mcp

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

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.

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

Frequently Asked Questions

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

Manage support threads, including status updates, assignments, and priorities.. Full CRUD operations for help centers, articles, and article categories.. Customer management including searching, grouping, and spam marking.. AI-powered generation of help center articles directly from support threads.. Internal note-taking and custom event tracking on customer and thread timelines..

What can I use Plain.com MCP Server for?

Automating support ticket responses by drafting replies based on existing help center documentation.. Syncing customer data and support history between Plain.com and other internal tools.. Quickly summarizing long support threads into internal notes for team handovers.. Bulk updating help center article structures or categories via natural language commands..

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.

Conare · memory for coding agents

Turn this server into reusable context

Keep Plain.com MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Set up free$npx conare@latest

Prepare the server locally

Register it in Claude Code

Make your agent remember this setup

What it does

Tools 5

Environment Variables

Try it

Plain.com MCP Server

Setup

Available Tools (77)

Help Centers

Help Center Articles

Help Center Article Groups

Help Center Index

Knowledge Sources

Customers

Customer Groups

Threads

Thread Actions

Thread Labels

Thread Fields

Notes

Frequently Asked Questions

Turn this server into reusable context

Related MCP Servers