Skip to content

Latest commit

 

History

31 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Plain Support Plugin for Agents

A Cursor and Claude Code plugin that gives your agents direct access to the Plain customer support platform via its GraphQL API.

With this plugin, your agent can read customers, threads, conversations, help center articles, and more - directly from your terminal.

What can it do?

Resource Read Write
Customers List, get, search by name/email/external ID -
Threads List, get, search, read full timeline Add internal notes
Help Center List centers, articles, groups Create/update articles and groups
Companies List, get -
Tenants List, get -
Labels List -
Tiers & SLAs List, get with SLA configs -
Broadcasts List, get, search, send history, per-recipient deliveries, recipient preview Create, update, delete drafts. Never schedules or sends
Broadcast audiences List, get Create, update, delete
Workspace Get info -

Example use cases

  • "What are the open support threads for customer john@example.com?"
  • "Read the full conversation on thread th_01ABC and summarize it"
  • "Add a note to thread th_01ABC with my investigation findings"
  • "Create a help center article about how to reset passwords"
  • "Which customers are in the Enterprise tier?"
  • "How many channels would a broadcast to the Enterprise tier reach?"
  • "Draft a broadcast announcing bulk actions to our Enterprise tenants"
  • "Which recipients did last week's broadcast fail to reach, and why?"

Installation

Option 1: Install via npx skills

npx skills add team-plain/plain-support

Option 2: Install as a Claude Code plugin

# Try it locally first
claude --plugin-dir /path/to/plain-support

# Or install from a marketplace that includes this plugin
/plugin install plain-support@marketplace-name

Option 3: Clone manually

git clone git@github.com:team-plain/plain-support.git
claude --plugin-dir ./plain-support

Prerequisites

API key

In Plain, go to Settings > Machine users & API Keys to create an API key. Then set it as an environment variable:

export PLAIN_API_KEY="plainApiKey_..."

Add it to your shell profile (.bashrc, .zshrc, etc.) to persist across sessions.

Dependencies

The plugin requires curl and jq:

# macOS
brew install jq

# Ubuntu/Debian
sudo apt-get install jq

# curl is pre-installed on most systems

Usage

Once installed, invoke the skill in Claude Code:

/plain-support

Claude will then have access to all Plain API commands. You can ask questions naturally:

  • "List my open threads"
  • "Find the customer with email support@acme.com"
  • "Show me the timeline for thread th_01H..."
  • "Create a draft article about our refund policy"

License

MIT

About

No description, website, or topics provided.

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages