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 approvalunder the dashboard's Settings → API keys shows approve/deny forms right in the conversation — a form only you can click. With it on, review_pending_approvals walks you through everything already waiting, including items queued in an earlier conversation.
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 sign-in connector reaches one workspace at a time, and it never guesses which: if your account spans several, it refuses with a clear message until you tell it. Pick a default workspace on the dashboard's Integrations page, and the connector uses that one from its next request on — no reconnecting needed unless your client has already given up on the connection. You can change or clear it there at any time.
A workspace that runs several assistants is the other half of this, and has no picker: connect the specific one you want with its per-workspace API-key URL, copied from that same Integrations page (it looks like https://api.getyawp.ai/mcp/agents/<assistant>). That URL is also the answer if you would rather not set a default at all.
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].