Odichat MCP server
io.github.odichat/mcp-odichat·v1.0.0Manage your Odichat WhatsApp/IG/FB inbox from Claude: conversations, contacts, pipeline, reports.
0 stars
Reviews
Write oneNobody has reviewed Odichat yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Odichat tools (130, 65 write)
write = sends, deletes, buys or postsaccount_getFreeRetrieve information about the specified Odichat account
account_updatewrite actionFreeUpdate attributes of the specified Odichat account
agent_bots_createwrite actionFreeCreate a new agent bot for the account
agent_bots_deletewrite actionFreeDelete an agent bot from the account
agent_bots_getFreeGet details of a specific agent bot
agent_bots_listFreeList all agent bots for the account
agent_bots_updatewrite actionFreeUpdate an existing agent bot
agents_createwrite actionFreeAdd a new agent to the account
agents_deletewrite actionFreeRemove an agent from the account
agents_listFreeList all agents in the account
agents_updatewrite actionFreeUpdate an agent in the account
audit_logs_listFreeList audit log events for the account
automation_rules_createwrite actionFreeCreate a new automation rule
automation_rules_deletewrite actionFreeDelete an automation rule
automation_rules_getFreeGet a specific automation rule
automation_rules_listFreeList all automation rules for the account
automation_rules_updatewrite actionFreeUpdate an existing automation rule
canned_responses_createwrite actionFreeCreate a new canned response
canned_responses_deletewrite actionFreeDelete a canned response
canned_responses_listFreeList all pre-defined canned responses for the account
canned_responses_updatewrite actionFreeUpdate an existing canned response
contact_labels_listFreeList all labels assigned to a contact
contact_labels_setFreeReplace all labels on a contact with the provided list of labels
contacts_contactable_inboxesFreeGet list of inboxes that can be used to reach a specific contact
contacts_conversationsFreeList all conversations for a specific contact
contacts_createwrite actionFreeCreate a new contact with name, phone (E.164), email, and custom attributes
contacts_create_contact_inboxwrite actionFreeCreate a contact inbox association (link contact to inbox)
contacts_deletewrite actionFreeDelete a contact
contacts_filterFreeFilter contacts using advanced filter conditions (POST with payload)
contacts_getFreeGet a specific contact by ID
contacts_listFreeList contacts in the account with pagination
contacts_mergeFreeMerge two contacts together. The base contact is kept y the mergee is merged into it.
contacts_searchFreeSearch contacts by query string (searches name, email, phone, identifier)
contacts_updatewrite actionFreeUpdate an existing contact
conversation_assignments_assignFreeAssign a conversation to an agent and/or team
conversations_createwrite actionFreeCreate a new conversation
conversations_filterFreeFilter conversations with advanced filter conditions
conversations_getFreeGet a specific conversation by ID
conversations_get_labelsFreeGet labels assigned to a conversation
conversations_listFreeList conversations with optional filters
conversations_metaFreeGet conversation metadata (counts by status: open, unassigned, assigned, etc.)
conversations_reporting_eventsFreeGet reporting events for a conversation
conversations_set_custom_attributesFreeSet custom attributes on a conversation
conversations_set_labelsFreeReplace all labels on a conversation
conversations_toggle_priorityFreeSet the priority of a conversation
conversations_toggle_statusFreeChange conversation status (open, resolved, pending, snoozed)
conversations_updatewrite actionFreeUpdate conversation attributes
custom_attributes_createwrite actionFreeCreate a custom attribute definition (text, number, date, list, checkbox, link)
custom_attributes_deletewrite actionFreeDelete a custom attribute definition
custom_attributes_getFreeGet a specific custom attribute definition
custom_attributes_listFreeList all custom attribute definitions for the account
custom_attributes_updatewrite actionFreeUpdate a custom attribute definition
custom_filters_createwrite actionFreeCreate a new custom filter for conversations
custom_filters_deletewrite actionFreeDelete a custom filter
custom_filters_getFreeGet a specific custom filter
custom_filters_listFreeList all saved custom filters for conversations
custom_filters_updatewrite actionFreeUpdate an existing custom filter
help_center_articles_createwrite actionFreeCreate an article in a help center portal
help_center_categories_createwrite actionFreeCreate a category in a help center portal
help_center_portals_createwrite actionFreeCreate a new help center portal
help_center_portals_listFreeList all help center portals
help_center_portals_updatewrite actionFreeUpdate a help center portal
inbox_members_createwrite actionFreeAdd agents to an inbox
inbox_members_deletewrite actionFreeRemove agents from an inbox
inbox_members_listFreeList agents assigned to an inbox
inbox_members_updatewrite actionFreeReplace all agents in an inbox (removes agents not in list)
inboxes_createwrite actionFreeCreate a new inbox (channel). The channel object varies by type.
inboxes_getFreeGet information about a specific inbox
inboxes_get_agent_botFreeGet the agent bot associated with an inbox
inboxes_listFreeList all communication channel inboxes in the account
inboxes_set_agent_botFreeSet or unset the agent bot for an inbox
inboxes_updatewrite actionFreeUpdate an inbox
integrations_create_hookwrite actionFreeCreate an integration hook (webhook for integration)
integrations_delete_hookwrite actionFreeDelete an integration hook
integrations_list_appsFreeList all available third-party integration apps
integrations_update_hookwrite actionFreeUpdate an integration hook
kanban_audit_events_getFree[Odichat] Get a specific audit event from a kanban task
kanban_audit_events_listFree[Odichat] List audit events (activity log) for a kanban task
kanban_boards_createwrite actionFree[Odichat] Create a new kanban board
kanban_boards_deletewrite actionFree[Odichat] Delete a kanban board
kanban_boards_getFree[Odichat] Get a specific kanban board
kanban_boards_listFree[Odichat] List all kanban boards in the account
kanban_boards_updatewrite actionFree[Odichat] Update a kanban board
kanban_boards_update_agentswrite actionFree[Odichat] Update the agents assigned to a kanban board
kanban_steps_createwrite actionFree[Odichat] Create a new step (column) in a kanban board
kanban_steps_deletewrite actionFree[Odichat] Delete a step from a kanban board
kanban_steps_getFree[Odichat] Get a specific step in a kanban board
kanban_steps_listFree[Odichat] List all steps in a kanban board
kanban_steps_updatewrite actionFree[Odichat] Update a step in a kanban board
kanban_tasks_createwrite actionFree[Odichat] Create a new task in a kanban board
kanban_tasks_deletewrite actionFree[Odichat] Delete a kanban task
kanban_tasks_getFree[Odichat] Get a specific task
kanban_tasks_listFree[Odichat] List tasks in a kanban board
kanban_tasks_moveFree[Odichat] Move a kanban task to a different step and/or position
kanban_tasks_updatewrite actionFree[Odichat] Update a kanban task
labels_createwrite actionFreeCreate a label in the account so it can be applied to conversations and contacts
labels_deletewrite actionFreeDelete a label and remove it from every conversation and contact that carries it
labels_listFreeList all labels defined in the account
labels_updatewrite actionFreeUpdate an existing label
message_templates_listFree[Odichat] List the WhatsApp message templates available on an inbox. Templates are scoped per inbox, not per account. The response includes unapproved templates — only those with status 'approved' can be sent.
messages_createwrite actionFreeSend a message in a conversation
messages_deletewrite actionFreeDelete a message from a conversation
messages_listFreeList messages in a conversation
profile_getFreeGet the profile of the currently authenticated user/agent
reports_account_overviewFreeGet account-level conversation metrics
reports_account_summaryFreeGet account summary (conversations count, incoming messages, etc.) for a time range
reports_agent_summaryFreeGet agent-level summary statistics for a time range
reports_conversation_metricsFreeGet conversation-level metrics (resolution time, first response, etc.)
reports_v2_agentsFreeGet v2 agent performance reports
reports_v2_inboxesFreeGet v2 inbox performance reports
reports_v2_teamsFreeGet v2 team performance reports
scheduled_messages_createwrite actionFree[Odichat] Schedule a message to be sent later in a conversation. Defaults to status 'pending' so the message is actually delivered — a 'draft' is stored but never sent.
scheduled_messages_create_call_reminderswrite actionFree[Odichat] Schedule the two WhatsApp call reminders for a booked call: "call_reminder_1h" one hour before, and "call_ongoing_now" at the call time. Give the call time as a naive local time plus an IANA timezone; the tool converts to UTC. The no-show follow-up is not scheduled — a human sends that one manually.
scheduled_messages_create_from_templatewrite actionFree[Odichat] Schedule an approved WhatsApp template message in a conversation. Looks the template up by its friendly_name on the conversation's own inbox, fills in the contact's name automatically, and schedules it for delivery. Only Twilio-backed WhatsApp inboxes are supported. Use message_templates_list to see the available names.
scheduled_messages_deletewrite actionFree[Odichat] Delete a scheduled message
scheduled_messages_listFree[Odichat] List scheduled messages for a conversation
scheduled_messages_updatewrite actionFree[Odichat] Update a scheduled message
team_members_addFreeAdd agents to a team
team_members_deletewrite actionFreeRemove agents from a team
team_members_listFreeList agents in a team
team_members_updatewrite actionFreeReplace all agents in a team (removes agents not in list)
teams_createwrite actionFreeCreate a new team
teams_deletewrite actionFreeDelete a team
teams_getFreeGet a specific team
teams_listFreeList all teams in the account
teams_updatewrite actionFreeUpdate a team
webhooks_createwrite actionFreeCreate a new webhook that receives event notifications at the given URL
webhooks_deletewrite actionFreeDelete a webhook
webhooks_listFreeList all webhooks configured in the account
webhooks_updatewrite actionFreeUpdate a webhook URL or subscriptions
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 738ms20/20
- Tool poisoning130 tool descriptions checked15/15
- Auth qualityopen endpoint exposes 65 write-action tools with no auth3/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Findings (1)
- highWrite-action tools reachable without authentication
auth.open-write
How Odichat compares
Against every graded Email MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 75% of 916 Email servers
- Tools
- 130
- the typical Email server has 7
- Tools that change things
- 50%
- typical: 25%. Fewer write tools means less an agent can break
What its tools let an agent do: 63 read · 63 change · 4 send or post
Install Odichat in Claude Code, Cursor or VS Code
claude mcp add --transport http mcp-odichat https://mcp.odichat.app/mcp?token={token}What the publisher says
From the Odichat repository's README, as published. We do not edit it. Read it on GitHub
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_id is 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 installEnvironment 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 devProduction (stdio)
bun run startProduction (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.tsOr with Docker:
docker build -t mcp-odichat .
docker run -p 3000:3000 mcp-odichatThe 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 claudedesktopconfig.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
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Odichat: common questions
- Is Odichat MCP server safe?
- Mostly: it is graded B (83/100). Read the Odichat safety report
- How do I install Odichat?
- It runs remotely at mcp.odichat.app. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Odichat need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Odichat maintained?
- The last commit was 39 days ago (2026-09-26). The latest release is v1.0.0.
- What can I use instead of Odichat?
- Servers from other publishers that do the same job: Zenvia MCP server, Inbox Zero MCP server and Atomic Mail MCP server.
- How does Odichat compare with other Email MCP servers?
- safety score 83/100 (higher than 75% of 916 Email servers); tools 130 (the typical Email server has 7); tools that change things 50% (typical: 25%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Odichat
Same job from other publishers: the closest match first, then the best rated.
- ZenviaMCP server for Zenvia — SMS, WhatsApp, RCS, Email, Voice, Facebook messaging, templates and reportsnot reviewedGrowingB
Inbox ZeroSearch Gmail and Outlook, save drafts, manage email rules, and view email stats.not reviewedEstablishedA- Atomic MailProgrammable email inbox for AI agents — JMAP, PoW auth, stdio MCP server.not reviewedEstablishedA
- Email Inbox API + Sending by SendmuxAI email inbox and sending tools with attachments, search, live events, and webhooks.not reviewedEstablishedA
- three.ws NotificationsRead the inbox, mark items read, manage delivery preferences, and register Web Push devices.not reviewedEstablishedB