Skip to content
Plain Help Center home
Plain Help Center home

Connecting Plain to AI Tools

The Plain Support Skill gives AI tools direct access to your Plain workspace via the GraphQL API.

Once installed, your agent can read customers, threads, conversations, help center articles, and more.

The skill uses your Plain API key to authenticate, so the agent will only have access to what that API key permits.

Compatible agents

The Plain Support Skill follows the open Agent Skills specification and works with any compatible agent, including:

Installation

Install the skill using the skills CLI:

npx skills add team-plain/plain-support

The installer will ask which agent(s) you want to install to. You can also specify the agent directly:

npx skills add team-plain/plain-support -a claude-code
npx skills add team-plain/plain-support -a codex
npx skills add team-plain/plain-support -a opencode

Alternatively, you can clone the repository manually:

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

Prerequisites

API key

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

export PLAIN_API_KEY="plainApiKey_..."

Add this to your shell profile (.bashrc, .zshrc, etc.) so it persists across sessions.

Dependencies

The skill requires curl and jq. On most systems curl is already installed. For jq:

# macOS
brew install jq

# Ubuntu/Debian
sudo apt-get install jq

What you can 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

—

Workspace

Get info

—

Use case examples

  • Debug a customer issue end to end: Ask your agent to look up a customer, read their thread timeline, and summarize the conversation. Then use that context to investigate the bug in your codebase and put up a fix, all in one session.

  • Research customer history before a call: "Show me everything about customer john@acme.com". The agent will pull their profile, open threads, and recent conversations so you're fully briefed.

  • Add investigation notes: After debugging an issue, tell the agent to add your findings as an internal note on the thread so your team has context.

  • Draft help center content: Ask the agent to create a new help center article based on patterns it sees in support threads. It can write the HTML content and publish it directly to your Plain help center.

  • Ad hoc analysis: "Which customers are in the Enterprise tier?" or "Show me all open threads with priority 0". Query your support data conversationally.

Example prompts

  • "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?"

  • "List my open threads"

Source code

The skill is open source and available on GitHub: github.com/team-plain/skills

Powered by Plain