relation-mcp

A Model Context Protocol server for Re:lation (by 株式会社インゲージ). Lets Claude / Claude Code / any MCP client search and triage support tickets, create internal records, and inspect the address book directly from an agent.

Works against the official Re:lation REST API (https://<tenant>.relationapp.jp/api/v2/). Read the full API reference at developer.ingage.jp.

Features

• search_tickets — filter by status, assignee, labels, free-text query

• get_ticket / update_ticket — fetch detail, change status/assignee/labels

• reply_mail — customer-facing email reply, guarded by a confirm_send: true interlock

• list_mail_accounts — discover the mail_account_id needed for reply_mail

• create_record — post an internal 応対メモ (not visible to the customer)

• create_comment — post a team comment on a ticket

• search_customers / get_customer — address-book lookup

• list_labels / list_users — reference data for scripting automations

• Built-in token-bucket rate limiter (stays under the 60 req/min tenant limit)

• Typed errors (RelationApiError, RelationAuthError, RelationRateLimitError)

Safety note on reply_mail

reply_mail sends a real email to the customer on the ticket. To keep agents from accidentally firing it during tool chaining, the tool requires a confirm_send: true parameter — if missing or false, the call is rejected before hitting the Re:lation API. Use it deliberately.

Related MCP server: mcp-movidesk

Install

npm install -g relation-mcp
# or run ad-hoc with npx
npx relation-mcp

Configure

Generate an access token in Re:lation (admin UI → API token), then export:

export RELATION_SUBDOMAIN=yourtenant          # the part before .relationapp.jp
export RELATION_MESSAGE_BOX_ID=1              # default 受信箱 ID
export RELATION_ACCESS_TOKEN=your_token_here

A copy of .env.example is included for reference.

Use with Claude Code / Claude Desktop

Add this to your MCP config (e.g. ~/.claude/config.json or the Claude Desktop config):

{
  "mcpServers": {
    "relation": {
      "command": "npx",
      "args": ["-y", "relation-mcp"],
      "env": {
        "RELATION_SUBDOMAIN": "yourtenant",
        "RELATION_MESSAGE_BOX_ID": "1",
        "RELATION_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

Then prompt the agent:

Find tickets where status is open and the subject contains "本人確認", then summarize the top 5.

Tool reference

All tools accept an optional message_box_id to override the default for a single call.

Development

git clone https://github.com/sewon-supernova/relation-mcp.git
cd relation-mcp
npm install
npm run typecheck
npm test
npm run build

Run locally against a real tenant:

cp .env.example .env   # fill in values
npm run build
node dist/index.js     # speaks MCP over stdio

Roadmap

• list_message_boxes

• list_pending_reasons / list_case_categories

• Pagination helpers (auto-iterate page)

• Prompt templates (MCP prompts/*) for common triage flows

• E2E tests against a staging tenant

• Docker image

License

MIT — see full text.

Not affiliated with 株式会社インゲージ

This is an unofficial, community-maintained client. "Re:lation" and "relationapp.jp" are trademarks of their respective owners.