# Zenvia MCP (CodeSpar)

> A community MCP server that lets your agent send SMS, WhatsApp, RCS, email and voice messages from your Zenvia account.

Zenvia MCP (CodeSpar) is a local MCP server for Zenvia, the Brazilian customer-communication platform. It's made by CodeSpar, a third party that publishes open-source MCP servers for Latin American services; Zenvia doesn't make or support it. The server calls Zenvia's API with your own API token, so your agent can send messages from the senders and channels set up on your Zenvia account.

What you can do with it
- Send SMS, WhatsApp, RCS, email, voice (text-to-speech or a recorded audio file) and Facebook Messenger messages (send_sms, send_whatsapp, send_rcs, send_email, send_voice, send_facebook_message).
- Send a pre-approved WhatsApp template with its variables, and list your approved templates (send_template, list_templates).
- Create, list and delete webhook subscriptions for incoming messages and status updates (create_subscription, list_subscriptions, delete_subscription).
- List and delete contacts in your Zenvia contact base (list_contacts, delete_contact).

How it connects
It runs on your computer with npx -y @codespar/mcp-zenvia and reads your token from the ZENVIA_API_TOKEN environment variable. You get the token from the Zenvia dashboard (app.zenvia.com). CodeSpar's docs show setup for Claude Code, Claude Desktop, Cursor and VS Code.

Good to know
- It's MIT-licensed and calls Zenvia directly; nothing goes through CodeSpar's own servers.
- Zenvia offers a sandbox in its dashboard for testing messages before you send to real customers.
- Five of its tools (get_message_status, list_channels, get_report_entries, add_opt_out and create_contact) call addresses or send fields that don't match Zenvia's current API reference, so expect errors from them.
- It's a community project by CodeSpar, not an official Zenvia product.

- Type: Plugin
- Made by: codespar
- Category: Communication
- Formats: Local MCP
- Version: 0.2.2
- Website: https://codespar.dev/servers/zenvia
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/communication/zenvia
- Page: https://pluginboard.ai/plugins/mcp-zenvia

## Works with

- Claude
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `ZENVIA_API_TOKEN` (required): API key for zenvia

Replace each `<NAME>` placeholder with your own value.

### Claude

Add to claude_desktop_config.json:

```json
{
  "mcpServers": {
    "zenvia-mcp-codespar": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-zenvia@0.2.2"
      ],
      "env": {
        "ZENVIA_API_TOKEN": "<ZENVIA_API_TOKEN>"
      }
    }
  }
}
```

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22zenvia-mcp-codespar%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40codespar%2Fmcp-zenvia%400.2.2%22%5D%2C%22env%22%3A%7B%22ZENVIA_API_TOKEN%22%3A%22%3CZENVIA_API_TOKEN%3E%22%7D%7D

Run in your terminal:

```shell
code --add-mcp '{"name":"zenvia-mcp-codespar","command":"npx","args":["-y","@codespar/mcp-zenvia@0.2.2"],"env":{"ZENVIA_API_TOKEN":"<ZENVIA_API_TOKEN>"}}'
```

Copilot CLI:

```shell
copilot mcp add zenvia-mcp-codespar --env ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> -- npx -y @codespar/mcp-zenvia@0.2.2
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=zenvia-mcp-codespar&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjb2Rlc3Bhci9tY3AtemVudmlhQDAuMi4yIl0sImVudiI6eyJaRU5WSUFfQVBJX1RPS0VOIjoiPFpFTlZJQV9BUElfVE9LRU4%2BIn19

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "zenvia-mcp-codespar": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-zenvia@0.2.2"
      ],
      "env": {
        "ZENVIA_API_TOKEN": "<ZENVIA_API_TOKEN>"
      }
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add -e ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> zenvia-mcp-codespar -- npx -y @codespar/mcp-zenvia@0.2.2
```

### Codex

Run in your terminal:

```shell
codex mcp add --env ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> zenvia-mcp-codespar -- npx -y @codespar/mcp-zenvia@0.2.2
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "zenvia-mcp-codespar": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-zenvia@0.2.2"
      ],
      "env": {
        "ZENVIA_API_TOKEN": "<ZENVIA_API_TOKEN>"
      }
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add -e ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> zenvia-mcp-codespar npx -y @codespar/mcp-zenvia@0.2.2
```

### OpenClaw

In a terminal: Run openclaw mcp add zenvia-mcp-codespar --command npx, with --arg before each argument (-y @codespar/mcp-zenvia@0.2.2) and --env NAME=value for each variable it needs.

### OpenCode

Run in your terminal:

```shell
opencode mcp add zenvia-mcp-codespar --env ZENVIA_API_TOKEN=<ZENVIA_API_TOKEN> -- npx -y @codespar/mcp-zenvia@0.2.2
```

### Hermes Agent

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "zenvia-mcp-codespar": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-zenvia@0.2.2"
      ],
      "env": {
        "ZENVIA_API_TOKEN": "<ZENVIA_API_TOKEN>"
      }
    }
  }
}
```

---
From Pluginboard (https://pluginboard.ai).