Claude Code + Bird · Build and Debug Messaging from Your Terminal — Bird

Ship and debug customer messaging straight from Claude Code.

Connect Claude Code to Bird’s MCP server and agent skills to verify sending domains, wire transactional Email, SMS, WhatsApp, OTP verification, and Voice into your codebase, and inspect bounces or live calls from your terminal without copy-pasting API keys or cURL commands.

From prompt to delivered.

Send messages and check delivery from your code, terminal, or AI assistant.

MCP CLI

Node.js
Python
Go
PHP
Serverless
REST

YouVoice

Can you check which calls are active right now and tell me which are connected and which are still ringing?

Bird MCP4 connected actions

  1. 1 Read the workspace workspace_get
  2. 2 Find calls in progress voice_legs_list
  3. 3 Inspect the connected call voice_legs_get
  4. 4 Inspect the ringing call voice_legs_get

YouEmail

Send a welcome email to delivered@messagebird.dev from onboarding@messagebird.dev, then check it arrived.

Bird MCP3 connected actions

  1. 1 Read the workspace workspace_get
  2. 2 Send the welcome email email_send
  3. 3 Confirm recipient delivery email_get

YouSMS

Text the code 123456 to +14155550100 from +15557654321 and check the delivery status.

Bird MCP4 connected actions

  1. 1 Read the workspace workspace_get
  2. 2 Send the SMS code sms_send
  3. 3 Read the message status sms_get
  4. 4 Check the delivery event sms_list_events

YouWhatsApp

Send code 123456 to +14155550100 on WhatsApp using our approved bird_otp template, then check it arrived.

Bird MCP4 connected actions

  1. 1 Read the template catalog whatsapp_templates_list
  2. 2 Send the approved template whatsapp_send
  3. 3 Read the message status whatsapp_get
  4. 4 Check the delivery event whatsapp_list_events

YouEmail + WhatsApp

Send my test customer a welcome email and WhatsApp code 123456 using our approved bird_otp template, then check both arrived.

Bird MCP4 connected actions

  1. 1 Send the welcome email email_send
  2. 2 Send the approved template whatsapp_send
  3. 3 Confirm recipient delivery email_get
  4. 4 Read the message status whatsapp_get

Connect Claude Code to your Bird workspace in three terminal steps.

Install the Bird plugin to register the hosted MCP server alongside CLI workflow and domain-audit skills, then authorize your workspace in the browser.

Terminal · Plugin Copy commands

claude plugin marketplace add messagebird/bird-ai
claude plugin install bird@bird-ai

Terminal · Standalone MCP server Copy command

claude mcp add --transport http bird https://mcp.bird.com

Install the plugin

Run the plugin commands above to register Bird’s hosted MCP server alongside the CLI workflow and email domain-audit skills. If you prefer to connect the MCP server without the skills, run the standalone server command instead.

To install the skills standalone for local CLI workflows, run npx skills add messagebird/bird-ai.

Authorize the connection

Open the MCP menu in Claude Code, select Bird, and complete the browser consent screen to grant workspace access.

Confirm your active workspace

Ask your agent to confirm your signed-in account and active workspace before running your first messaging task. Seeing your user identity and workspace details confirms the connection is ready.

Run real messaging diagnostics and setup tasks with plain-language prompts.

Ask Claude Code to audit failed email deliveries, configure an SMS sender for order notifications, or inspect active Voice calls against your live Bird workspace.

Understand a delivery issue Copy prompt

Check my recent email failures. Group them by reason, inspect the affected sending domain, and tell me what needs fixing before making changes.

Prepare a new channel Copy prompt

Help me set up SMS for order updates. Check my workspace and available senders, explain what is missing, then prepare a test for a number I provide.

See what is happening now Copy prompt

List the Voice calls that are active right now. Separate connected calls from calls that are still ringing, and show their IDs.

How authentication, permissions, and workspace access work

What to know about browser sign-in, delegated workspace permissions, and troubleshooting before running live messaging commands in Claude Code.

Does connecting MCP give my agent unrestricted workspace access?

No. Claude Code operates strictly within the Bird role permissions you hold and grant during browser authorization, and asks before executing state-changing actions in your terminal. You can revoke the OAuth session from your Bird account settings whenever needed.

Do I need to generate an API key to use the hosted MCP server?

No. Bird’s hosted MCP server authenticates your terminal session through browser OAuth sign-in, so you do not need to paste API keys into local config files for interactive development. When your application sends Email, SMS, WhatsApp, or Voice traffic in production, it authenticates separately with its own scoped access key.

What should I check if Bird tools appear in Claude Code but requests fail?

Verify that your browser authorization is active. Registering the MCP server URL makes the tool definitions visible to Claude Code, and completing the browser sign-in flow authorizes requests against your workspace. Re-authenticate the Bird server from Claude Code’s MCP menu, then ask the agent to confirm your active account and workspace.

Extend your AI workflow across Bird.

Inspect the hosted MCP architecture, add domain-audit and CLI skills, or connect your workspace to additional coding agents.

MCP server

See how Bird’s hosted HTTP transport, browser OAuth sign-in, and scoped workspace tools handle live API requests.

Agent skills

Add open-source skills for Bird CLI workflows and DNS, SPF, DKIM, and DMARC email deliverability audits.

Supported AI tools

Connect the same Bird workspace and MCP toolset in Cursor, Codex, Windsurf, and other MCP-compatible editors.

Start building with Bird in minutes.