CallNode MCP server
Commit Oct 22, 2026Allows AI assistants to read call and message history, send SMS/MMS, and place calls using CallNode phone numbers.
Also known as cnchg/CallNode
- Stars
- 0
- Tools
- 13
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 22, 2026
- License
- MIT
What is CallNode MCP?
CallNode allows AI assistants to read call and message history, send SMS/MMS, and place calls using CallNode phone numbers. It exposes 13 tools, such as list_numbers, get_number, list_calls.
Summary generated from the project's README
About CallNode MCP server
CallNode provides a hosted MCP server that connects your CallNode phone numbers directly to AI assistants. This setup allows users to integrate communication capabilities into platforms like Claude Desktop, ChatGPT, Cursor, and VS Code without installing local software. By providing a server URL and using an OAuth-based consent process, you can grant an assistant permission to interact with specific phone numbers you have selected in your dashboard.
Once connected, the assistant can perform various communication tasks using tools like send_message, place_call, and list_messages. You can manage permissions granularly, choosing whether the AI can read history, send SMS/MMS, or manage your phone book. The system includes safety features such as an hourly send cap and time-of-day restrictions to ensure messages and calls occur during appropriate local hours. This makes it a practical solution for developers who want to automate telephony tasks through a conversational interface.
What you can do with it
- 1Review communication historyAsk your AI assistant to summarize recent interactions or check the status of previous messages.
- 2Automate outbound messagingInstruct the assistant to send a text or a picture to a specific contact or phone number.
- 3Execute voice callsHave the AI place a phone call using a voice agent to handle the conversation based on your instructions.
- 4Manage contact listsUse the assistant to look up names in your phone book or add new contacts to your directory.
Written from the project's README. Every use case is checked against a quote from it.
How to install CallNode MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall CallNode MCP in Claude Code
$ claude mcp add --transport http callnode https://mcp.callnode.io/mcpInstall CallNode MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"callnode": {
"url": "https://mcp.callnode.io/mcp"
}
}
}Install CallNode MCP in VS Code
.vscode/mcp.json
{
"servers": {
"callnode": {
"type": "http",
"url": "https://mcp.callnode.io/mcp"
}
}
}Install CallNode MCP in VS Code CLI
$ code --add-mcp '{"name":"callnode","type":"http","url":"https://mcp.callnode.io/mcp"}'Install CallNode MCP in Codex
$ codex mcp add callnode --url https://mcp.callnode.io/mcpInstall CallNode MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.callnode] url = "https://mcp.callnode.io/mcp"
Install CallNode MCP in Gemini CLI
$ gemini mcp add -s user --transport http callnode https://mcp.callnode.io/mcpInstall CallNode MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"callnode": {
"url": "https://mcp.callnode.io/mcp",
"type": "http"
}
}
}CallNode MCP tools 13
Detected from the READMElist_numbersget_numberlist_callsget_callplace_calllist_messagesget_messagesend_messagelist_phone_bookadd_phone_book_contactremove_phone_book_contactget_balance
| list_numbers | — | |
| get_number | — | |
| list_calls | — | |
| get_call | — | |
| place_call | — | |
| list_messages | — | |
| get_message | — | |
| send_message | — | |
| list_phone_book | — | |
| add_phone_book_contact | — | |
| remove_phone_book_contact | — | |
| get_balance | — |
Show all 13 toolsShow fewer tools
get_updates
| get_updates | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablecnchg/callnode is public and reachablegithub.com/cnchg/callnode ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-22github.com/cnchg/callnode ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubCallNode MCP server
Your CallNode phone numbers, inside your AI assistant.
CallNode hosts a Model Context Protocol (MCP) server at:
https://mcp.callnode.io/mcp
Sign in to it from claude.ai, Claude Desktop, ChatGPT, Claude Code, Cursor or VS Code, then tick the numbers the assistant may use. It can then:
- read your call and message history;
- send texts and picture messages;
- call or text your Phone Book contacts by name;
- once you switch calling on, place calls that the CallNode voice agent runs.
The server is hosted by CallNode, so there is nothing to install or run. This repository holds only the connection details: client configs, the registry entry and this README.
- What it can do, in plain words: https://callnode.io/integrations/mcp
- Every tool, permission, limit and error code: https://callnode.io/docs/mcp
Before you connect
- Create an account at https://callnode.io/signup (no credit card to start) and get a number. Self-serve numbers are local and toll-free numbers in the US and Canada.
- Open Dashboard → MCP Server, switch MCP access on, and tick the numbers an assistant may use. Every connection shares this one list; a number you did not tick cannot be read from or sent from.
Connect
You give the client only the server URL. It sends you to the CallNode consent page, and you approve. No token is created, and nothing secret is pasted into a file or a shell.
On the consent page you can untick permissions (sending, for example), choose a live or test connection, and set an hourly send cap. Afterwards the connection appears under Dashboard → MCP Server, and you can revoke it there at any time.
claude.ai and Claude Desktop
- Open Settings → Connectors and choose Add custom connector.
- Enter
https://mcp.callnode.io/mcpas the server URL and continue. Leave the client id and secret fields empty. - Claude opens the CallNode sign-in page. Log in if asked, review the numbers and permissions, and approve.
- Back in Claude, enable the connector in a chat.
ChatGPT
- Enable Developer mode under Settings → Connectors → Advanced, then choose Create.
- Enter
https://mcp.callnode.io/mcpas the MCP server URL and pick OAuth for authentication. No client id or secret is needed, because ChatGPT registers itself. - Approve on the CallNode sign-in page, then add the connector to a chat.
Claude Code
Either use .mcp.json from this repository in your project, or run this once:
claude mcp add --transport http callnode https://mcp.callnode.io/mcp
Inside Claude Code, type /mcp, pick callnode and choose Authenticate. Approve in the browser.
VS Code (Copilot agent mode)
- Save
.vscode/mcp.jsonin your workspace, then start the callnode server. VS Code opens the CallNode consent page; approve. - In Copilot Chat, choose Agent mode and tick the callnode tools.
Cursor
- Save
.cursor/mcp.jsonin your project, or the same entry in~/.cursor/mcp.json, then reload Cursor. - In Settings → MCP the server shows Needs login. Click it and approve in the browser.
Without a browser sign-in
For automations where a browser sign-in isn't possible, create a token connection in the dashboard. The snippets for each client are at https://callnode.io/docs/mcp#clients.
Tools
Each tool is bound to a permission you grant. A connection without that permission does not see the tool at all.
| Tool | Permission | What it does |
|---|---|---|
list_numbers |
numbers:read |
The enabled numbers, with what each can do and whether it has its own voice agent. |
get_number |
numbers:read |
One enabled number. Never webhook addresses, routing or credentials. |
list_calls |
calls:read |
Call records on the enabled numbers, newest first. No transcripts. |
get_call |
calls:read |
One call record, including how it ended. For calls placed through MCP: the summary, outcome and transcript. |
place_call |
calls:place |
Place a call. The CallNode voice agent runs it from your instructions, or the number's own voice webhook does. Off by default. |
list_messages |
messages:read |
SMS/MMS history on the enabled numbers. |
get_message |
messages:read |
One message, with its delivery status. |
send_message |
messages:send |
Send a text or picture message, to a number or to a Phone Book contact by name. |
list_phone_book |
phonebook:read |
Your Phone Book: your own lines, with their labels. |
add_phone_book_contact |
phonebook:manage |
Prepares an entry and returns a link. Only you can certify and save it. |
remove_phone_book_contact |
phonebook:manage |
Removes a Phone Book entry. |
get_balance |
account:read |
Your prepaid balance and auto-recharge settings. |
get_updates |
messages:read |
New inbound texts (and calls, when the connection can read calls) since the last check, with an optional wait of up to 20 seconds. |
send_message and place_call are marked as actions that reach a person and cannot be undone (destructiveHint), so clients that honour tool hints ask you before running them.
Safety and limits
- Numbers. Only the numbers you tick are visible, and no token can widen that list.
- Same rules as the API. Sends and calls go through the same rules as the CallNode API:
- opt-outs and STOP replies are honoured;
- texts and calls fall inside 8am–9pm in the recipient's local time, except your own certified Phone Book lines;
- sending numbers must be registered for messaging;
- calls need business verification, and do-not-call lists, destination restrictions and your concurrent-call limit apply;
- your balance must cover each send.
- Per-connection limits:
- 30 sends an hour by default, settable from 1 to 200;
- an identical text to the same recipient within 60 seconds is sent once;
- 10 calls an hour, and the same from/to pair within 60 seconds is never dialled twice;
- 120 tool calls a minute.
- The voice agent introduces itself as an AI assistant calling on behalf of your business and never claims to be human. It cannot transfer a call or take card details.
- Untrusted content. Message bodies and caller-supplied text reach the assistant marked as untrusted, so a text that tries to give it instructions reads as data.
- Activity log. Every tool call, allowed or refused, appears under Recent activity in your dashboard. Message contents are never stored there.
- Revoking. A revoked connection is refused on its next request. A sign-in lapses after 90 days without a fresh one.
- Test connections run every rule, then simulate the send or the call. Nothing leaves the platform and nothing is charged.
Pricing
The MCP server has no fee. Texts and calls are billed from your prepaid balance at your normal rates, and calls the CallNode voice agent runs add a per-minute rate for the voice. All rates are on https://callnode.io/pricing.
Support
- Help: support@callnode.io
- Security reports: security@callnode.io
- Privacy: https://callnode.io/privacy
- Terms: https://callnode.io/terms
- Security: https://callnode.io/security
Files in this repository
| File | For |
|---|---|
server.json |
The Official MCP Registry entry (io.callnode/mcp) |
.mcp.json |
Claude Code |
.vscode/mcp.json |
VS Code |
.cursor/mcp.json |
Cursor |
These files are released under the MIT License. The CallNode service itself is covered by the CallNode Terms.
CallNode MCP questions
How do I add CallNode MCP to Claude Code?
Run claude mcp add --transport http callnode https://mcp.callnode.io/mcp in your terminal. Add --scope user to make it available in every project.
How do I add CallNode MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does CallNode MCP provide?
It exposes 13 tools, including list_numbers, get_number, list_calls, get_call, place_call.
How do I connect CallNode to my AI assistant?
You provide the server URL to your client, which redirects you to a CallNode consent page to approve permissions and select specific phone numbers.
Are there any fees for using the MCP server?
The MCP server itself has no additional fee, but texts and calls are billed from your prepaid CallNode balance at normal rates.
Can the AI assistant place phone calls?
Yes, once calling is switched on, the assistant can place calls that are handled by the CallNode voice agent.