Connector documentation
Use Yawp inside Claude or ChatGPT.
Yawp is an assistant that gets real-world errands done — phone calls and email, on your behalf. Connected to Claude or ChatGPT, you can hand it an errand mid-conversation and get the outcome back where you asked. This page is the complete setup reference.
How do I connect from Claude?
In Claude (web or desktop): Settings → Connectors → Add connector, and give it this URL:
https://api.getyawp.ai/mcpClaude opens a sign-in window; approve the connection and you are done. If you don't have a Yawp account yet, you can create one during that sign-in — finish the short setup at app.getyawp.ai afterwards so your assistant has what it needs.
In Claude Code, one command does the same:
claude mcp add --transport http yawp https://api.getyawp.ai/mcpHow do I connect from ChatGPT?
In ChatGPT: Settings → Connectors → Add connector (in some workspaces this lives behind developer mode), then paste the same URL:
https://api.getyawp.ai/mcpChatGPT walks you through the OAuth sign-in. Yawp asks for nothing beyond your Yawp account — no ChatGPT data leaves the conversation except what you explicitly send to your assistant.
What should I try first?
An email errand works the moment you connect — it needs no phone number. Paste this and change the details:
Have Yawp email my brother ([email protected]) to find a time for coffee next week. My schedule: free Tuesday and Thursday after 5pm.Phone calls need a Yawp phone number first — activate one under Settings → Phone number in the dashboard. Then:
Call my dentist at +1 555 000 1234 and ask if they can move my Thursday cleaning to any time Tuesday afternoon.How do approvals work?
Nothing reaches a real person without your say-so. When Yawp drafts a call or an email, it queues the exact thing it wants to do, and the draft waits for you. In ChatGPT — and anywhere else without inline approval forms — you approve by reading an 8-digit approval code from your Yawp dashboard and giving it to the assistant. The code lives only on the dashboard, so a confused (or manipulated) AI can never approve its own work: only you can read it.
In Claude Desktop with an API-key connector, you can enable inline approval instead: the key setting Allow inline approvalon the dashboard's Integrations page shows approve/deny forms right in the conversation — a form only you can click.
Which tools does the connector expose?
Everything is scoped to your workspace; reads are reads, and anything that touches the outside world is gated behind the approvals above.
I'm in multiple workspaces (or have multiple assistants)
The OAuth connector supports the common shape: one account, one workspace, one assistant. If your account spans several workspaces — or a workspace runs several assistants — the connector refuses with a clear message instead of guessing which one you meant. Connect the specific one you want with its per-workspace API-key URL instead, copied from the dashboard's Integrations page (it looks like https://api.getyawp.ai/mcp/agents/<assistant>).
Troubleshooting
- “This authorization is no longer valid” — disconnect and reconnect the connector; your sign-in was revoked or expired.
- “No Yawp workspace yet” — finish account setup at app.getyawp.ai, then reconnect.
- “No phone number configured” — calls need a Yawp number: dashboard → Settings → Phone number. Email errands work without one.
- “Token verification is temporarily unavailable” — a hiccup on our side; retry in a minute. Your connection is fine.
- Connected but no tools listed — remove the connector and add it again with the exact URL above.
Is my data safe?
Every outbound message and call discloses that Yawp is an assistant acting for a named person — see how Yawp works for what recipients are told. What Yawp stores and why is in the privacy policy. Questions or trouble connecting: [email protected].