Bird MCP server
Commit Nov 13, 2026Enables AI agents to send and receive communications across email, SMS, WhatsApp, and voice through a single API.
Also known as messagebird/bird-ai, bird-ai
- Stars
- 9
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.173.0
- Last commit
- Nov 13, 2026
- License
- MIT
What is Bird MCP?
Bird enables AI agents to send and receive communications across email, SMS, WhatsApp, and voice through a single API.
Summary generated from the project's README
About Bird MCP server
Bird provides a unified communications interface that allows AI agents to manage email, SMS, WhatsApp, and voice interactions through a single API. Developers can integrate these capabilities into various coding environments by installing the Bird CLI and connecting to a hosted MCP server located at mcp.bird.com. The system supports multiple clients including Claude Code, Cursor, Codex, GitHub Copilot, Factory Droid, and OpenCode.
Setup involves installing the CLI via curl or Homebrew and authenticating through a browser-based OAuth flow. For users without an existing account, the CLI enables a self-serve signup process that uses email verification and allows for the creation of organizations and workspaces in specific regions like us1 or eu1. Once authenticated, agents can utilize specific skills and workflows to drive communication tasks directly from the terminal or integrated development environment.
What you can do with it
- 1Automated communication setupAn agent can install the CLI, sign in, and send a test email to verify the connection.
- 2Multi-channel messagingDevelopers can instruct an AI to send messages across different platforms like WhatsApp or SMS using one login.
- 3Account and workspace managementUsers can create new organizations and workspaces directly from the terminal without needing a password.
Written from the project's README. Every use case is checked against a quote from it.
How to install Bird MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Bird MCP in Claude Code
$ claude mcp add --transport http bird-ai https://mcp.bird.com/Install Bird MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"bird-ai": {
"url": "https://mcp.bird.com/"
}
}
}Install Bird MCP in VS Code
.vscode/mcp.json
{
"servers": {
"bird-ai": {
"type": "http",
"url": "https://mcp.bird.com/"
}
}
}Install Bird MCP in VS Code CLI
$ code --add-mcp '{"name":"bird-ai","type":"http","url":"https://mcp.bird.com/"}'Install Bird MCP in Codex
$ codex mcp add bird-ai --url https://mcp.bird.com/Install Bird MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.bird-ai] url = "https://mcp.bird.com/"
Install Bird MCP in Gemini CLI
$ gemini mcp add -s user --transport http bird-ai https://mcp.bird.com/Install Bird MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"bird-ai": {
"url": "https://mcp.bird.com/",
"type": "http"
}
}
}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 reachablemessagebird/bird-ai is public and reachablegithub.com/messagebird/bird-ai ↗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-11-13github.com/messagebird/bird-ai ↗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 model0 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 GitHubBird AI Marketplace
Skills for driving the Bird platform from your coding agent. Your agent operates Bird through the bird CLI; the bird plugin in this marketplace installs the skills that teach it Bird's workflows, and on clients that read the plugin's MCP declaration it wires up Bird's hosted MCP server too.
Quick start
Every client starts the same way: install the CLI and sign in.
curl -fsSL https://cli.bird.com/install.sh | sh # install the bird CLI
bird auth login # sign in (browser, no API key)
On macOS or Linux you can also install with Homebrew: brew install messagebird/tap/bird.
Then jump to your client below. The fastest path is to paste the setup prompt and let your agent do the rest; a manual path is under each one.
No Bird account yet?
bird auth login signs in to an account you already have. An agent with no account can create one from the terminal — no browser, no password. Three commands take you from nothing to a stored credential:
# 1. Sign up. Emails a six-digit code to the address; no password is set.
bird auth signup you@example.com
# 2. Verify. Read the code from that email, then exchange it for a single-use onboarding ticket.
bird auth verify-email you@example.com --code 123456
# → { "onboarding_ticket": "obt_…", "user_id": "usr_…" }
# 3. Create your first org + workspace. Consumes the ticket, then mints and stores the credential.
# --region picks where the account and its data live (us1 or eu1); the CLI routes there for you.
bird auth create-org "Acme" --workspace-name "Production" --region us1 --onboarding-ticket obt_…
# Confirm it worked — reports the account, org, and workspace you're now acting as.
bird auth status
The code arrives by email, so it comes from outside the CLI — read it from the inbox and pass it to step 2. Signup and verification are region-agnostic; you pick the region once, at create-org, so there is no host or environment variable to set. Every step is self-describing: append --help for the flags, --example for a ready-to-edit request body, or --response-schema for what it returns — none of them need a credential, so an agent can plan the whole chain before running it. Full walkthrough: Self-serve signup.
Any Agent Plugins client
The plugin ships a root plugin.json and mcp.json following Agent Plugins, the portable plugin format. A client that implements the specification loads it from this repository as it is: the skills and the hosted MCP server, in one install. Point the client at github.com/messagebird/bird-ai and install bird from plugins/bird.
For a client with its own plugin format, or none, find it below.
Claude Code
Paste this prompt into Claude Code and it installs the CLI, signs you in, installs the skills, and sends a test email:
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's skills so you know the workflows: run `claude plugin marketplace add messagebird/bird-ai`, then `claude plugin install bird@bird-ai`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from onboarding@messagebird.dev, then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.
Or install the plugin manually:
claude plugin marketplace add messagebird/bird-ai
claude plugin install bird@bird-ai
MCP server: installing the plugin registers Bird's hosted server at https://mcp.bird.com, so there is nothing to configure. You do have to sign in once, because the server is OAuth-gated: run /mcp, select bird, press Enter, and choose Authenticate. Your browser opens Bird's consent screen; approve it and the tools work. Until then claude mcp list reports bird as ! Needs authentication and every tool call fails. For a headless run (claude -p) there is no /mcp panel, so authenticate first with claude mcp login bird.
Cursor
Paste this prompt into Cursor:
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Give yourself Bird's skills (Cursor installs plugins through its UI, so set them up by file instead): fetch the skills from https://github.com/messagebird/bird-ai and write them into `.cursor/rules/` as `.mdc` files.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from onboarding@messagebird.dev, then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.
To set the skills up by hand, add the messagebird/bird-ai marketplace under Settings → Plugins, or write the skills from this repo into .cursor/rules/ as .mdc files yourself.
MCP server: add the hosted server once in ~/.cursor/mcp.json:
{
"mcpServers": {
"bird": { "url": "https://mcp.bird.com" }
}
}
Then sign in: open Customize in the Cursor sidebar, select MCPs, and follow the sign-in prompt for bird. Approve Bird's consent screen in the browser and return to Cursor. The tools fail until you do.
Codex
Paste this prompt into Codex:
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's skills so you know the workflows: run `codex plugin marketplace add messagebird/bird-ai`, then `codex plugin add bird@bird-ai` (check `codex plugin --help` if the exact form differs).
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from onboarding@messagebird.dev, then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.
Or install the plugin manually:
codex plugin marketplace add messagebird/bird-ai
codex plugin add bird@bird-ai
MCP server: the plugin registers https://mcp.bird.com automatically.
Then sign in, which opens your browser for Bird's consent screen:
codex mcp login bird
GitHub Copilot
Paste this prompt into Copilot:
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's skills so you know the workflows: run `copilot plugin marketplace add messagebird/bird-ai`, then `copilot plugin install bird@bird-ai`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from onboarding@messagebird.dev, then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.
Or install the plugin manually:
copilot plugin marketplace add messagebird/bird-ai
copilot plugin install bird@bird-ai
MCP server: add the hosted server once in .vscode/mcp.json:
{
"servers": {
"bird": { "type": "http", "url": "https://mcp.bird.com" }
}
}
VS Code asks you to trust the server the first time it starts, then runs the sign-in itself: approve Bird's consent screen in the browser window it opens. If no window appears, start bird from the MCP: List Servers command. Your grant is listed under the Accounts menu → Manage Trusted MCP Servers, which is also where you revoke it.
Factory Droid
Paste this prompt into Droid:
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's skills so you know the workflows: Droid loads skills from `.factory/skills/`, so clone https://github.com/messagebird/bird-ai and copy every directory in `plugins/bird/skills/` into `.factory/skills/`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from onboarding@messagebird.dev, then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.
To set the skills up by hand:
git clone https://github.com/messagebird/bird-ai
cp -r bird-ai/plugins/bird/skills/. .factory/skills/
MCP server: add the hosted server once:
droid mcp add bird https://mcp.bird.com --type http
Then run /mcp inside droid and complete the browser sign-in from the server manager.
OpenCode
Paste this prompt into OpenCode:
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's OpenCode plugin so you know the workflows: run `opencode plugin github:messagebird/bird-ai --global`, then tell me to restart OpenCode and run `opencode mcp auth bird`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from onboarding@messagebird.dev, then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.
Or install the plugin by hand:
opencode plugin github:messagebird/bird-ai --global
opencode mcp auth bird
The plugin adds Bird's skills and the hosted MCP server to your OpenCode config. By default OpenCode adds every MCP tool to the model's context, so the plugin connects to https://mcp.bird.com/dynamic, which offers two tools: search finds the Bird tool for a task and execute runs it. With OpenCode's experimental code mode on (OPENCODE_EXPERIMENTAL_CODE_MODE=1, or OPENCODE_EXPERIMENTAL=1), OpenCode keeps MCP tools behind its own search, so the plugin connects to the full catalog at https://mcp.bird.com instead.
By default the plugin makes OpenCode ask before each call that can change your workspace: before bird_execute on /dynamic, and before every Bird tool in code mode. Your own opencode.json takes precedence: a bird_* rule you set, a single permission value for every tool, or a bird server you configured replaces the plugin's.
Google Antigravity
Paste this prompt into Antigravity:
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's Antigravity plugin so you know the workflows: run `curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash`, then tell me to open Customizations in the sidebar and authenticate `bird`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from onboarding@messagebird.dev, then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.
Or install the plugin by hand with Antigravity CLI:
agy plugin install https://github.com/messagebird/bird-ai
Or without Antigravity CLI:
curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash
The script downloads the plugin from this repository's main branch and installs it in ~/.gemini/config/plugins/bird, where Antigravity 2.0, the IDE, and Antigravity CLI load it in every workspace. To install it in one project, run it from the project root with bash -s -- --project, which writes .agents/plugins/bird. Run the same command again to update. From a clone of this repository, run bash antigravity.sh with the same options.
MCP server: the plugin registers Bird's hosted server at https://mcp.bird.com. You still sign in once, because the server is OAuth-gated: open Customizations in the sidebar (in the IDE, open Agent settings with Cmd+, on macOS or Ctrl+, elsewhere), and select Authenticate next to bird. If bird is not listed, restart Antigravity. Approve Bird's consent screen in the browser, copy the authorization code it shows, paste it into Antigravity, and select Submit. Until then every tool call fails.
These are local installation instructions; inclusion in Google's curated marketplace requires its separate review.
What's in the bird plugin
bird-cli: operate the Bird API from the terminal. One reference per CLI command group, covering sending and inspecting messages on every channel Bird runs, the setup each channel needs before it can send, one-time-passcode verification, recipient lookup, contacts and audiences, messaging preferences, Realtime provisioning, webhooks, API keys, support tickets, and documentation search.email-audit: grade a domain's live DMARC, SPF, DKIM, BIMI, and MX records and read the findings back as a prioritized fix list. DNS-only, so it needs no sign-in.- Bird MCP server: the hosted server at
https://mcp.bird.com, so your agent can call Bird directly with a browser sign-in and no API key. Registered for you on Claude Code, Codex, OpenCode, Antigravity and any Agent Plugins host; a one-time config elsewhere (above). Every client needs the one-time browser sign-in described in its section: the server is OAuth-gated, and a client that has the URL but no grant lists the tools and fails every call.
License
MIT.
Bird MCP questions
How do I add Bird MCP to Claude Code?
Run claude mcp add --transport http bird-ai https://mcp.bird.com/ in your terminal. Add --scope user to make it available in every project.
How do I add Bird MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I sign in to Bird?
You can sign in using the command bird auth login, which will open a browser for authentication.
Can I create an account without a browser?
Yes, an agent can create an account directly from the terminal using a series of signup, verification, and organization creation commands.
What communication channels does Bird support?
Bird allows you to operate email, SMS, WhatsApp, and voice through one API.
Is the MCP server gated by authentication?
Yes, the hosted MCP server is OAuth-gated and requires you to approve a consent screen in your browser.