mcp-zenvia — Claude Code MCP server: features and setup
Connect an agent to Zenvia to send messages across channels, manage contacts, and inspect reports. Useful when you want messaging actions available in an AI coding workflow.
claude mcp add mcp-zenvia -e ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> -- npx -y @codespar/mcp-zenviaWhat mcp-zenvia does
This MCP server gives an agent access to Zenvia messaging: SMS, WhatsApp, RCS, email, voice, and Facebook Messenger. It can also look up delivery status, manage contacts and approved templates, handle event subscriptions, and put phone numbers on the opt-out list.
A Zenvia API token is required. Set ZENVIA_API_TOKEN before connecting; without it, the server cannot authenticate with the API. In Claude Code, add the server with claude mcp add mcp-zenvia -e ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> -- npx -y @codespar/mcp-zenvia. Zenvia’s dashboard includes a sandbox for testing messages.
What it helps with
- send an SMS or WhatsApp message through an agent
- check delivery status using a message ID
- create or remove a Zenvia contact
- retrieve report entries for a date range
- suppress future messages to a phone number
Example prompts for the agent
- Send an SMS to the provided number saying the order is ready.
- Check delivery for message ID
msg-123. - Add this phone number to the opt-out list.
How to install mcp-zenvia
Platform CLI
claude mcp add mcp-zenvia -e ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> -- npx -y @codespar/mcp-zenviaReplace <…> with your own values
Platform CLI
codex mcp add zenvia --env ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> -- npx -y @codespar/mcp-zenviaReplace <…> with your own values
Config file
{
"mcpServers": {
"zenvia": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-zenvia"
],
"env": {
"ZENVIA_API_TOKEN": "<ZENVIA_API_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"zenvia": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-zenvia"
],
"env": {
"ZENVIA_API_TOKEN": "<ZENVIA_API_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> zenvia npx -y @codespar/mcp-zenviaReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-zenvia
How do I install mcp-zenvia in Claude Code?
Run claude mcp add mcp-zenvia -e ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> -- npx -y @codespar/mcp-zenvia. Replace the placeholder with your Zenvia token.
What does mcp-zenvia do?
It connects an agent to Zenvia so it can send messages through several channels. The server also provides access to contacts, templates, delivery status, and report entries.
What does mcp-zenvia need to run?
Set a Zenvia API token in ZENVIA_API_TOKEN. Zenvia’s dashboard sandbox can be used to test messages.
