Duckbill MCP connects your AI tools to Duckbill's human-powered phone calling service. Request calls, track tasks, and communicate with your agent — all through natural conversation with your AI assistant.
No copy-pasting phone numbers. No hold music. Just tell your AI what you need, and a real person makes the call for you.
Getting Started
1. Create a Duckbill account
Sign up at app.getduckbill.com/signup/mcp using your Gmail or Apple email address.
Claude users: Make sure your Duckbill account uses the same email as your Claude account. Claude automatically uses your Claude account email during authentication, and it must match.
Each phone call action costs approximately $5 (2 credits). See duckbill.ai for full plan and pricing details.
2. Connect your AI client
Follow the setup instructions below for your preferred tool.
Setup
Claude (Web & Desktop App)
Setup is the same for both claude.ai and the Claude Desktop app. Once connected on claude.ai, Duckbill also becomes available on Claude's mobile apps.
1. Open Connectors settings
Go to Settings → Connectors.
2. Add Duckbill as a custom connector
Click "Add custom connector" at the bottom of the page. In the dialog, enter:
Name: Duckbill
URL: https://mcp.duckbill.ai/mcp
Click Add.
3. Connect and authenticate
Duckbill will appear in your connectors list. Click "Connect" — a browser window will open asking you to authorize Duckbill MCP to access your account. Click "Allow" to complete the connection.
Note: MCP authentication currently uses Google or Apple SSO only. Please sign in with SSO, using the same email address as your Duckbill account, even if you don't normally use SSO for Duckbill. This works with @gmail.com, @icloud.com, and Google Workspace / iCloud custom domains, but not other custom domains yet. Email/password auth support coming soon!
And that's it! Start a new conversation and try it out. Duckbill is now available automatically.
Claude Code
Requires Claude Code installed and authenticated.
1. Add the Duckbill MCP server
Run:
claude mcp add --transport http duckbill https://mcp.duckbill.ai/mcp2. Launch Claude Code and authenticate
Open Claude Code by running claude in your terminal.
Once inside, run /mcp (select the Duckbill server if asked) and choose the option to Authenticate.
A browser window will open — sign in with the same email associated with your Duckbill account.
Note: MCP authentication currently uses Google or Apple SSO only. Please sign in with SSO, using the same email address as your Duckbill account, even if you don't normally use SSO for Duckbill. This works with @gmail.com, @icloud.com, and Google Workspace / iCloud custom domains, but not other custom domains yet. Email/password auth support coming soon!
3. Confirm the connection
Run /mcp in Claude Code. You should see Duckbill listed with a connected status. That's it — you're ready to make requests.
ChatGPT
ChatGPT support requires Developer Mode and is not available inside ChatGPT Projects. This is a limitation of ChatGPT's current MCP implementation, not Duckbill.
1. Enable Developer Mode
In ChatGPT (chatgpt.com, web-only), go to Settings → Apps & Connectors → Advanced settings (at the bottom of the page) and toggle Developer Mode on.
2. Create a new app
Go to Settings → Apps & Connectors and click Create. In the "New App" dialog, enter:
Name: Duckbill MCP
MCP Server URL: https://mcp.duckbill.ai/mcp
Authentication: OAuth
Check the box to acknowledge "I understand and want to continue," then click Create.
3. Authenticate
A browser window will open. Sign in with the same email associated with your Duckbill account and click "Allow".
Note: MCP authentication currently uses Google or Apple SSO only. Please sign in with SSO, using the same email address as your Duckbill account, even if you don't normally use SSO for Duckbill. This works with @gmail.com, @icloud.com, and Google Workspace / iCloud custom domains, but not other custom domains yet. Email/password auth support coming soon!
4. Enable Duckbill in a conversation
Open a new chat (not inside a Project). Click the "+" button near the message composer, click "More", and select Duckbill from the list of available tools.
What you can do
The Duckbill MCP server gives your AI assistant five tools:
| Tool | What it does |
|---|---|
| Request a call | Ask a human agent to make a phone call on your behalf — reservations, appointments, inquiries, and more. |
| List tasks | See all your active call requests, including pending and in-progress tasks. |
| Get task status | Check the results of a specific call — what happened, conversation history, and current progress. |
| Send a message | Provide additional context or answer questions from the agent handling your call. |
| Cancel a task | Cancel a pending call request if you no longer need it. |
Each task represents one phone call made by a real person on your behalf. Calls are typically made within 2–3 hours during business hours.
Using Duckbill
You don't need to reference tool names — just use natural language.
Request a call:
Call Marea in NYC and book a table for 4 this Saturday at 7:30pm.
Check on your tasks:
What's the status of my Duckbill tasks?
Send additional context:
For my restaurant reservation, let them know we need a shellfish-free table.
Cancel a request:
Cancel my reservation request.
FAQs
As a secondary Duckbill account member, am I able to use the Duckbill MCP?
Yes, secondary members on Duckbill household accounts can connect and use the Duckbill MCP just like primary members.
For authentication/login, I only see SSO options. Can I log in to my Duckbill account with email/password?
MCP authentication currently uses Google or Apple SSO only. Please sign in with SSO, using the same email address as your Duckbill account, even if you don't normally use SSO for Duckbill. This works with @gmail.com, @icloud.com, and Google Workspace / iCloud custom domains, but not other custom domains yet. Email/password auth support coming soon!
If I cancel my Duckbill account, does that automatically disconnect me from the Duckbill MCP?
No, but if you cancel, once your subscription expires you'll get an error when trying to use the Duckbill MCP. (If you delete your account entirely, that error will happen nearly instantaneously.)
How do I disconnect the Duckbill MCP?
- Claude (web/desktop): Settings → Connectors → click "..." next to Duckbill → click Remove
- Claude Code: Run
claude mcp remove duckbillin terminal - ChatGPT: Settings → Apps & Connectors → click into Duckbill → Remove
Troubleshooting
Authentication fails or expires
In Claude Code: Run /mcp, select Duckbill, and choose Clear authentication, then Re-authenticate.
In Claude (web/desktop): Go to Settings → Connectors, click the "..." menu next to Duckbill, and remove it. Then re-add the connector and authenticate again.
In ChatGPT: Go to Settings → Apps & Connectors, click into the Duckbill connector, and remove it. Then re-create it.
ChatGPT: Connector not appearing or not working
Duckbill on ChatGPT requires Developer Mode enabled and must be used outside of Projects. Make sure both conditions are met. If the connector was created inside a Project, remove it and recreate it from a standard chat.
Connection stuck on loading
If the connector shows a loading spinner that doesn't resolve, try removing it and adding it again. Make sure you're using the correct URL:
https://mcp.duckbill.ai/mcp
Authentication fails on Claude (web/desktop)
Claude automatically uses your Claude account email for authentication. If your Claude email is different from your Duckbill email, authentication will fail. For now, make sure both accounts use the same email address. A fix is in progress.
Quick Reference
| Server URL | https://mcp.duckbill.ai/mcp |
| Auth method | OAuth via browser (Duckbill account required) |
| Supported emails | Gmail or Apple email |
| Cost per call | ~$5 (2 credits) |
| Sign-up link | app.getduckbill.com/signup/mcp |
| Claude plan required | Pro, Max, Team, or Enterprise |
| ChatGPT requirement | Developer Mode enabled, outside of Projects |