mcp-odichat
A Model Context Protocol (MCP) server that exposes the full Odichat API — including Odichat exclusive features — as 123 tools for use with AI assistants like Claude, ChatGPT, VS Code Copilot, and others.
Features
- 123 tools covering all Odichat API endpoints
- Account, Agents, Contacts, Conversations, Messages, Inboxes, Teams, and more
- Reports (v1 & v2), Help Center, Automation Rules, Custom Attributes, Custom Filters
- Odichat exclusive: Kanban Boards, Kanban Steps, Kanban Tasks, Kanban Audit Events, Scheduled Messages
- Proper MCP tool annotations (
readOnlyHint,destructiveHint,idempotentHint) - Multi-account support (
account_idis a per-tool argument) - Two transports:
- stdio — local subprocess (Claude Desktop, VS Code, and any MCP client)
- Streamable HTTP — remote, hosted server (Claude Web/Desktop/Code, ChatGPT). Stateless; the API token is passed per request via a
?token=query param
Requirements
- Bun v1.0+
- An Odichat instance with API access
Installation
bun install
Environment Variables
In HTTP mode the token is not read from the environment — each client supplies its own token via the
?token=query param, keeping the server stateless and multi-tenant.
Usage
Development
bun run dev
Production (stdio)
bun run start
Production (remote HTTP server)
Run the server over HTTP with Bun.serve() and the web-standard Streamable HTTP transport:
MCP_TRANSPORT=http PORT=3000 bun run src/index.ts
Or with Docker:
docker build -t mcp-odichat .
docker run -p 3000:3000 mcp-odichat
The server is stateless — no database, no sessions. Each request must include the
caller's Odichat API token as a ?token= query param. SSL is expected to be
terminated by an upstream proxy (e.g. Traefik).
Endpoints:
Connecting to a hosted server
Point any remote-MCP-capable client (Claude Web/Desktop/Code, ChatGPT) at the server URL with your token in the query string:
https://mcp.odichat.app/mcp?token=YOUR_API_TOKEN
- In Odichat, go to Profile → Access Token and copy your token.
- Add the URL above (with your token) as the MCP server URL in your AI client.
Local (stdio) client configuration
Claude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"odichat": {
"command": "bun",
"args": ["run", "/path/to/mcp-odichat/src/index.ts"],
"env": {
"ODICHAT_API_TOKEN": "your-api-token"
}
}
}
}
VS Code Configuration
Add to your .vscode/mcp.json:
{
"servers": {
"odichat": {
"command": "bun",
"args": ["run", "${workspaceFolder}/src/index.ts"],
"env": {
"ODICHAT_API_TOKEN": "your-api-token"
}
}
}
}
ChatGPT Configuration
ChatGPT connects to remote MCP servers over HTTP — see Connecting to a hosted server above.
Available Tools (123)
Account (2)
account_get, account_update
Agent Bots (5)
agent_bots_list, agent_bots_create, agent_bots_get, agent_bots_update, agent_bots_delete
Agents (4)
agents_list, agents_create, agents_update, agents_delete
Audit Logs (1)
audit_logs_list
Automation Rules (5)
automation_rules_list, automation_rules_create, automation_rules_get, automation_rules_update, automation_rules_delete
Canned Responses (4)
canned_responses_list, canned_responses_create, canned_responses_update, canned_responses_delete
Contacts (11)
contacts_list, contacts_create, contacts_get, contacts_update, contacts_delete, contacts_conversations, contacts_search, contacts_filter, contacts_create_contact_inbox, contacts_contactable_inboxes, contacts_merge
Contact Labels (2)
contact_labels_list, contact_labels_set
Conversations (12)
conversations_meta, conversations_list, conversations_create, conversations_filter, conversations_get, conversations_update, conversations_toggle_status, conversations_toggle_priority, conversations_set_custom_attributes, conversations_get_labels, conversations_set_labels, conversations_reporting_events
Conversation Assignments (1)
conversation_assignments_assign
Messages (3)
messages_list, messages_create, messages_delete
Custom Attributes (5)
custom_attributes_list, custom_attributes_create, custom_attributes_get, custom_attributes_update, custom_attributes_delete
Custom Filters (5)
custom_filters_list, custom_filters_create, custom_filters_get, custom_filters_update, custom_filters_delete
Help Center (5)
help_center_portals_list, help_center_portals_create, help_center_portals_update, help_center_categories_create, help_center_articles_create
Inboxes (10)
inboxes_list, inboxes_get, inboxes_create, inboxes_update, inboxes_get_agent_bot, inboxes_set_agent_bot, inbox_members_list, inbox_members_create, inbox_members_update, inbox_members_delete
Integrations (4)
integrations_list_apps, integrations_create_hook, integrations_update_hook, integrations_delete_hook
Profile (1)
profile_get
Reports (9)
reports_account_overview, reports_account_summary, reports_agent_summary, reports_conversation_metrics, reports_v2_overview, reports_v2_agents, reports_v2_inboxes, reports_v2_teams, reports_v2_labels
Teams (9)
teams_list, teams_create, teams_get, teams_update, teams_delete, team_members_list, team_members_add, team_members_update, team_members_delete
Webhooks (4)
webhooks_list, webhooks_create, webhooks_update, webhooks_delete
Kanban Boards (6) — [Odichat]
kanban_boards_list, kanban_boards_create, kanban_boards_get, kanban_boards_update, kanban_boards_delete, kanban_boards_update_agents
Kanban Steps (5) — [Odichat]
kanban_steps_list, kanban_steps_create, kanban_steps_get, kanban_steps_update, kanban_steps_delete
Kanban Tasks (6) — [Odichat]
kanban_tasks_list, kanban_tasks_create, kanban_tasks_get, kanban_tasks_update, kanban_tasks_delete, kanban_tasks_move
Kanban Audit Events (2) — [Odichat]
kanban_audit_events_list, kanban_audit_events_get
Scheduled Messages (4) — [Odichat]
scheduled_messages_list, scheduled_messages_create, scheduled_messages_update, scheduled_messages_delete
Development
# Run tests
bun test
# Lint & format
bun run lint
bun run format
# Type check
bun run build-check
# Full check (lint + type-check + tests)
bun run check
License
MIT