# mcp-zenvia

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/communication/zenvia
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-zenvia

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ZENVIA_API_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-zenvia -e ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> -- npx -y @codespar/mcp-zenvia
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add zenvia --env ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> -- npx -y @codespar/mcp-zenvia
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "zenvia": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-zenvia"
            ],
            "env": {
                "ZENVIA_API_TOKEN": "<ZENVIA_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "zenvia": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-zenvia"
            ],
            "env": {
                "ZENVIA_API_TOKEN": "<ZENVIA_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> zenvia npx -y @codespar/mcp-zenvia
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md