OsmO Phone Calls
OfficialThis server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
You: Call the pharmacy on Main Street and ask if they're open until 9 tonight.
AI: I'll call Main Street Pharmacy (+1 555 0100) and ask whether they're open until 9 tonight. OK?
You: Yes.
AI: (OsmO places the call, then reports what the pharmacy said, with a summary and transcript.)This is an illustration of the flow, not a recorded conversation. The number is a placeholder.
What it looks like
In ChatGPT and Claude, OsmO shows each call as a live card: who it is calling, whether the call is going on, then the result, a summary, the recording when there is one, and Call again. Up to five calls share one card. Claude also shows cards for places to call, your recent calls, a call's details and your assistant. Grok, Cursor and other MCP clients get the same answers as text. Screenshots use sample data.
New users get 50 free credits at getosmo.app/login, in the US, Canada, the UK and Australia. An answered call uses 3 credits, however long it is. A call nobody answers is free. With free credits, OsmO calls businesses and toll-free numbers; calling your contacts and scheduling calls need an OsmO app plan.
Related MCP server: Dialfetch MCP
Contents
How it works
sequenceDiagram
participant You
participant AI as Your AI app
participant OsmO as OsmO MCP server<br/>(api.getosmo.app)
participant Phone as The person or business
You->>AI: "Call the clinic and move my appointment"
AI->>OsmO: place_call (preview, nothing dialled)
OsmO-->>AI: who will be called, the number, what will be said
AI->>You: "OK to call?"
You->>AI: "Yes"
AI->>OsmO: place_call (confirmed)
OsmO->>Phone: real phone call by OsmO's voice AI
AI->>OsmO: get_call_status
OsmO-->>AI: outcome, summary (transcript via get_call)
AI->>You: what was saidThere is nothing to install or run on your machine. Your AI app connects to OsmO's hosted MCP server. You sign in once in the browser with your phone number and a one-time code. There is no API key.
Connect your AI
Every app uses the same server URL: https://api.getosmo.app/mcp (Streamable HTTP, OAuth).
When you first connect, the app opens OsmO's sign-in page. Enter your phone number and the
one-time code there, never in the chat.
The "Guide" column links to OsmO's own step-by-step page for that app.
App | How to connect | Guide |
ChatGPT | Plugins → search OsmO → Connect, or open the OsmO listing | |
Claude (web, desktop, mobile) | Customize → Connectors → + Add → Add custom connector → URL | |
Claude Code |
| |
Cursor | Click Install in Cursor above, or add | |
VS Code (GitHub Copilot) | Click Install in VS Code above, or run MCP: Add Server and choose HTTP, or add the JSON below | |
Codex (CLI, IDE) |
| |
Gemini CLI |
| |
Antigravity | Install the plugin from this repo ( | — |
Grok (grok.com) | grok.com/connectors → New Connector → Custom → URL | |
Grok Build |
| |
Perplexity (Pro, Max, Enterprise) | Plugins → Add custom → Add MCP connector → Remote → URL | |
OpenClaw |
| |
Hermes | add the YAML below, then | — |
Cline, Windsurf, OpenCode, any MCP client | add a remote (Streamable HTTP) server with the URL above and OAuth sign-in. Cline: see | — |
We have not tested the rows with no guide (OpenClaw, Hermes, Cline, Windsurf, OpenCode) end to end ourselves. Those rows follow each client's own documented syntax. If a command is out of date for your version, please open an issue.
Claude Code plugin
The plugin adds the MCP server and the osmo-phone-calls skill, which tells the AI to confirm
before every call. Inside Claude Code:
/plugin marketplace add getosmo/osmo-ai-plugins
/plugin install osmo@osmoOn recent Claude Code versions this works in one step:
/plugin install osmo --marketplace getosmo/osmo-ai-plugins.
Then type /mcp, pick osmo and sign in. Install either the plugin or the claude mcp add server,
not both, so Claude doesn't see two copies of the tools.
Codex plugin
The plugin carries the MCP server and the skill. In your shell:
codex plugin marketplace add getosmo/osmo-ai-plugins
codex plugin add osmo@osmo
codex mcp login osmoVS Code
.vscode/mcp.json (workspace) or your user mcp.json:
{
"servers": {
"osmo": {
"type": "http",
"url": "https://api.getosmo.app/mcp"
}
}
}Cursor
~/.cursor/mcp.json or .cursor/mcp.json:
{
"mcpServers": {
"osmo": {
"url": "https://api.getosmo.app/mcp"
}
}
}OpenClaw
openclaw skills install @getosmo/osmo-phone-calls
# optional, one job each (same server, same sign-in):
# @getosmo/osmo-ai-receptionist, @getosmo/osmo-call-screening,
# @getosmo/osmo-customer-service-calls, @getosmo/osmo-book-by-phone
openclaw mcp set osmo '{"url":"https://api.getosmo.app/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login osmoHermes
~/.hermes/config.yaml, then hermes mcp login osmo:
mcp_servers:
osmo:
url: "https://api.getosmo.app/mcp"
auth: oauthOpenCode
opencode.json (follows OpenCode's documented remote-server syntax; not yet tested by us):
{
"mcp": {
"osmo": {
"type": "remote",
"url": "https://api.getosmo.app/mcp"
}
}
}Example prompts
"Call the pharmacy on Main Street and ask if they're open until 9."
"Call my dentist and move my appointment to next Tuesday afternoon."
"Find the customer-care number for my airline and ask about my refund."
"Get me a table for 4 at Luigi's on Friday at 8 pm."
"Ask the hardware store on Elm Street if they have a 10 mm socket set in stock."
What it can and can't do
With free credits, OsmO calls businesses and toll-free numbers; calling your contacts and scheduling calls need an OsmO app plan.
With any account, including free credits:
Book, reschedule or cancel an appointment or a table.
Ask a shop, clinic or restaurant about opening hours, prices, stock or an order.
Get through a company's phone menu to customer service.
Call listed businesses (shops, clinics, restaurants, helplines) and toll-free numbers, up to 5 in one go.
Find a business near you, or a company's customer-care number, in your own country.
Report the outcome, a summary and the transcript of every call it made, with a ▶ Play recording link.
In apps that show MCP Apps cards (such as Claude), show a live call card: confirm the call, follow it from placed to in call to ended, read the summary, play the recording, and tap Call again or Schedule. Up to 5 calls placed together show in one card, a row per person.
In Claude and ChatGPT, wait for a short call to finish so its result comes back in the same turn.
Offer to call again (now or later, with the same words) when a call did not get what you needed.
Guard against placing the same confirmed call twice when your AI app sends it again.
With an OsmO app plan (iOS, Android):
Call your saved contacts and people who called you in the last 30 days, for example to pass a message.
Schedule a call for later in your own time zone (safe across daylight-saving changes), and list scheduled calls in your local time or cancel them.
Tell you who called your OsmO number and what they wanted, with the transcript and recording.
Run your AI receptionist: pause the AI, choose who is put through live, edit VIP and block lists and caller rules, switch the assistant or its language (English or Hindi), and read bookings, Facts and calendar or Drive connection status. The greeting, assistant names and voice are changed in the OsmO app.
Read your chats with OsmO in the app.
It can't or won't:
Call emergency services. Dial your local emergency number yourself.
Send text messages or email.
Call personal numbers found on the web.
Need card numbers, bank PINs, passwords or sign-in codes typed into the chat. None of its tools take them, the skill tells your AI never to ask for them, and the sign-in code goes on OsmO's own page.
Dial anything before you say yes.
Calls come from the OsmO number for your country. The voice AI speaks English, Spanish and Hindi.
Cost
New users (US, Canada, UK, Australia) | 50 free credits when you sign in at getosmo.app/login. No card. Calls businesses and toll-free numbers. |
An answered call | 3 credits, however long it is |
A call nobody answers | free |
Contacts, scheduled calls, screening | need an OsmO app plan. Signing in to the app ends any free credits you have left. |
After the free credits |
If your free credits run out, the tools say so and point you to the OsmO app (getosmo.app/app).
Safety and privacy
You confirm every call.
place_callfirst returns a preview: who will be called, the number, what will be said and when. Nothing is dialled until your AI sends it back with your approval. Changing or deleting a setting or rule works the same way.Sign-in happens on OsmO's page, not in the chat. Never paste the one-time code into a chat. No API key or password is stored in this repo or in your AI app's config.
One host. Everything goes to
https://api.getosmo.appover HTTPS. This repo has no scripts, hooks or executable code.Annotations. Every tool declares MCP annotations (
readOnlyHint,destructiveHint,openWorldHint). Tools that place calls are marked destructive and open-world, so well-behaved clients ask before running them.Disconnect by removing OsmO from your AI app's connector settings. If you use the OsmO app, also open the Sharing card → Connect AI apps → Disconnect. If you only use OsmO from AI apps, email team@getosmo.app with the mobile number you signed in with and we will end the access.
Read the privacy policy and terms.
Tools
The server's tools/list is the source of truth. This is what a standard MCP client (Claude,
Cursor, Codex, Gemini CLI, Grok and others) gets today: 27 tools. ChatGPT is served the release its
directory review approved, so its tool text can differ slightly.
Tool | What it does | Changes something? |
| Call one number, or up to 5. Returns a preview first. Calling contacts and booking for later need an OsmO app plan. | yes, after you confirm |
| Progress and result of a call OsmO placed | no |
| Cancel a call booked for later (OsmO app plan) | yes, after you confirm |
| Calls booked for later (OsmO app plan) | no |
| Your calls, newest first, with summaries | no |
| One call: summary, transcript, recording link | no |
| Businesses near a place, with phone numbers (Google Maps listings) | no |
| A company's customer-care numbers in your country | no |
| People in your call history | no |
| Your phone book (contacts synced by the OsmO app) | no |
| Receptionist settings: pause the AI, who is put through live, alerts, VIP and block lists | update: yes, after you confirm |
| Which assistant answers your calls, and in which language (English or Hindi). The greeting, names and voice are changed in the OsmO app. | update: yes, after you confirm |
| Call-screening rules | add, update, delete: yes, after you confirm |
| What your assistant tells callers (website, documents); read-only | no |
| Whether Google Calendar, Calendly and Google Drive are connected (status only) | no |
| Bookings your call assistant took or cancelled, upcoming or past | no |
| Your chats with OsmO in the app | no |
| Credits left (free-credit accounts), or plan, OsmO number and forwarding status (app accounts) | no |
| Help answers: forwarding codes, plans, privacy | no |
| What this integration can and can't do | no |
What's in this repo
This repo holds the client side only, under the MIT license. The OsmO server is a hosted service; its code is not in this repo.
Path | For |
Agent Skill. Tells the AI to confirm before calling, report only what the call result says, and never ask for codes. Published on ClawHub. | |
Agent Skill for the AI receptionist side: who called, pausing the AI, put-through, VIP and block lists, caller rules, assistant language, bookings, Facts. Changes are shown first and applied on a yes. Published on ClawHub. | |
Agent Skill for screening calls to your own number: spam calls, missed calls, the caller's message instead of voicemail, block and VIP lists, caller rules. Published on ClawHub. | |
Agent Skill for customer service calls: find a company's customer care number, get through the phone menu, wait on hold and bring back the answer. Published on ClawHub. | |
Agent Skill for booking by phone: restaurant reservations and appointments, made, moved or cancelled by a call. Published on ClawHub. | |
Claude Code plugin + marketplace (MCP server + skill) | |
Codex plugin (MCP server + skill) | |
Cursor plugin and MCP config | |
Gemini CLI extension | |
Antigravity plugin | |
Install steps written for AI agents (Cline and others) | |
Official MCP Registry metadata ( |
Authentication and network
https://api.getosmo.app/mcp: hosted MCP (Streamable HTTP)https://api.getosmo.app/.well-known/oauth-protected-resource/mcpand/.well-known/oauth-authorization-server: discoveryhttps://api.getosmo.app/mcp/oauth/authorize,/token,/register,/revoke: OAuth 2.1 with PKCE and dynamic client registrationhttps://api.getosmo.app/mcp/oauth/connect: the sign-in page (phone number + one-time code)
Scopes advertised by the server: osmo.help, calls.read, calls.write, offline_access.
Support, security and license
Help: getosmo.app/support or team@getosmo.app
Security reports: see SECURITY.md
Improving a client config or the skill: see CONTRIBUTING.md
License: MIT for the files in this repo (LICENSE). Using OsmO is governed by the OsmO terms and privacy policy.
If OsmO makes a call you'd rather not make yourself, a ⭐ on this repo helps other people find it.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Let AI agents place real phone calls from your verified number, with transcripts and recordings.
Give your AI assistant a real phone line. Place and end real phone calls with AI voice agents, read call transcripts, run a live two-way interpreter between two people who share no language (31 languages, browser link or phone), create and edit voice agents, and search, buy and bind phone numbers in 21 countries. OAuth 2.1 with PKCE — the model never sees your API key; a read-only scope is available. Pay as you go from $0.10/min, $5 free credit for new accounts.
Give your AI agent a phone. Place outbound calls to US businesses to ask, book, or confirm.
Place real phone calls and hold spoken conversations on a user's behalf, billed per minute.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to make real-world phone calls with AI voice technology and provides tools to track call status, transcripts, and summaries. It supports automated communication with both live numbers and simulated businesses for testing and demonstration purposes.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to place real phone calls, navigate IVR trees, and retrieve structured answers with transcripts and recordings.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to place real phone calls, engage in spoken conversations across 12 languages, and report the outcomes for tasks like booking appointments, answering questions, negotiating, or confirming orders.MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to place and steer real phone calls through ElevenLabs voice agents: draft a briefing with the number, language, goal and permitted facts, rehearse it in text, confirm to dial, then follow progress, answer the agent's questions mid-call, and retrieve the transcript, duration and cost. Includes guardrails such as a fixed AI disclosure line, per-person call and minute limits, number restrictions and retention-based deletion of calls and transcripts.103MIT