
OsmO Phone Calls — AI makes phone calls for you. MCP connector, agent skill, Cursor plugin and
OsmO Phone Calls — AI makes phone calls for you. MCP connector, agent skill, Cursor plugin and Gemini CLI extension.
·
Let your AI make real phone calls for you.
Ask ChatGPT, Claude, Cursor, Codex, Gemini CLI, Grok or any MCP client to call a shop, clinic,
restaurant or helpline. OsmO's voice AI makes the call and brings back
the answer, a summary and the transcript. It is also your AI phone receptionist: it answers
calls to your number, screens spam and takes messages and bookings.
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.
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.
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.
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 | guide |
| Claude (web, desktop, mobile) | Customize → Connectors → + Add → Add custom connector → URL https://api.getosmo.app/mcp | guide |
| Claude Code | claude mcp add --transport http osmo https://api.getosmo.app/mcp, then /mcp to sign in. Or the plugin (MCP + skill), below | guide |
| Cursor | Click Install in Cursor above, or add mcp.json to .cursor/mcp.json or ~/.cursor/mcp.json | guide |
| VS Code (GitHub Copilot) | Click Install in VS Code above, or run MCP: Add Server and choose HTTP, or add the JSON below | guide |
| Codex (CLI, IDE) | codex mcp add osmo --url https://api.getosmo.app/mcp, then codex mcp login osmo. Or the plugin, below | guide |
| Gemini CLI | gemini extensions install https://github.com/Mountainheads-Private-limited/osmo-ai-plugins, then /mcp auth osmo | guide |
| Antigravity | Install the plugin from this repo (.antigravity-plugin/, mcp_config.json), then Customizations › Installed › Authenticate under MCP Servers | — |
| Grok (grok.com) | grok.com/connectors → New Connector → Custom → URL https://api.getosmo.app/mcp | guide |
| Grok Build | grok mcp add --transport http osmo https://api.getosmo.app/mcp | guide |
| Perplexity (Pro, Max, Enterprise) | Plugins → Add custom → Add MCP connector → Remote → URL https://api.getosmo.app/mcp | guide |
| OpenClaw | openclaw skills install @getosmo/osmo-phone-calls, then the two commands below | ClawHub |
| Hermes | add the YAML below, then hermes mcp login osmo | — |
| Cline, Windsurf, OpenCode, any MCP client | add a remote (Streamable HTTP) server with the URL above and OAuth sign-in. Cline: see llms-install.md | — |
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.
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 Mountainheads-Private-limited/osmo-ai-plugins
/plugin install osmo@osmoOn recent Claude Code versions this works in one step:
/plugin install osmo --marketplace Mountainheads-Private-limited/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.
The plugin carries the MCP server and the skill. In your shell:
codex plugin marketplace add Mountainheads-Private-limited/osmo-ai-plugins
codex plugin add osmo@osmo
codex mcp login osmo.vscode/mcp.json (workspace) or your user mcp.json:
{
"servers": {
"osmo": {
"type": "http",
"url": "https://api.getosmo.app/mcp"
}
}
}~/.cursor/mcp.json or .cursor/mcp.json:
{
"mcpServers": {
"osmo": {
"url": "https://api.getosmo.app/mcp"
}
}
}openclaw skills install @getosmo/osmo-phone-calls
openclaw mcp set osmo '{"url":"https://api.getosmo.app/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login osmo~/.hermes/config.yaml, then hermes mcp login osmo:
mcp_servers:
osmo:
url: "https://api.getosmo.app/mcp"
auth: oauthopencode.json (follows OpenCode's documented remote-server syntax; not yet tested by us):
{
"mcp": {
"osmo": {
"type": "remote",
"url": "https://api.getosmo.app/mcp"
}
}
}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:
With an OsmO app plan (iOS, Android):
It can't or won't:
Calls come from the OsmO number for your country. The voice AI speaks English, Spanish and Hindi.
| 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 | keep calling with a plan in the OsmO app (iOS, Android) |
If your free credits run out, the tools say so and point you to the OsmO app (getosmo.app/app).
place_call first 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.https://api.getosmo.app over HTTPS. This repo has no scripts,
hooks or executable code.readOnlyHint, destructiveHint,
openWorldHint). Tools that place calls are marked destructive and open-world, so well-behaved
clients ask before running them.Read the privacy policy and terms.
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? |
|---|---|---|
place_call | 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 |
get_call_status | Progress and result of a call OsmO placed | no |
cancel_scheduled_call | Cancel a call booked for later (OsmO app plan) | yes, after you confirm |
list_scheduled_calls | Calls booked for later (OsmO app plan) | no |
list_calls / list_recent_calls | Your calls, newest first, with summaries | no |
get_call | One call: summary, transcript, recording link | no |
find_business | Businesses near a place, with phone numbers (Google Maps listings) | no |
find_customer_care | A company's customer-care numbers in your country | no |
find_contact | People in your call history | no |
search_contacts | Your phone book (contacts synced by the OsmO app) | no |
get_settings / update_settings | Call settings: answering, alerts, VIP and block lists | update: yes, after you confirm |
get_assistant / update_assistant | Which assistant voice and language answers your calls | update: yes, after you confirm |
list_rules / add_rule / update_rule / delete_rule | Call-screening rules | add, update, delete: yes, after you confirm |
get_facts | What your assistant tells callers (website, documents) | no |
get_connections | Whether Google Calendar, Calendly and Google Drive are connected | no |
list_bookings | Bookings your call assistant took | no |
list_chats / get_chat | Your chats with OsmO in the app | no |
get_account_status | Credits left (free-credit accounts), or plan, OsmO number and forwarding status (app accounts) | no |
osmo_support | Help answers: forwarding codes, plans, privacy | no |
osmo_help | What this integration can and can't do | no |
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 |
|---|---|
skills/osmo-phone-calls/SKILL.md | Agent Skill. Tells the AI to confirm before calling, report only what the call result says, and never ask for codes. Published on ClawHub. |
skills/osmo-ai-receptionist/SKILL.md | Agent Skill for the AI receptionist side: who called, greeting, caller rules, bookings. Changes are shown first and applied on a yes. Published on ClawHub. |
.claude-plugin/ | Claude Code plugin + marketplace (MCP server + skill) |
.codex-plugin/plugin.json | Codex plugin (MCP server + skill) |
.cursor-plugin/plugin.json, mcp.json | Cursor plugin and MCP config |
gemini-extension.json, GEMINI.md | Gemini CLI extension |
.antigravity-plugin/plugin.json, mcp_config.json | Antigravity plugin |
llms-install.md | Install steps written for AI agents (Cline and others) |
server.json | Official MCP Registry metadata (app.getosmo/phone-calls) |
https://api.getosmo.app/mcp: hosted MCP (Streamable HTTP)https://api.getosmo.app/.well-known/oauth-protected-resource/mcp and
/.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.
If OsmO makes a call you'd rather not make yourself, a ⭐ on this repo helps other people find it.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add osmo --transport http https://api.getosmo.app/mcp{
"mcpServers": {
"osmo": {
"url": "https://api.getosmo.app/mcp",
"type": "http"
}
}
}code --add-mcp '{"name":"osmo","url":"https://api.getosmo.app/mcp","type":"http"}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/osmo-ai-plugins to learn what the "Osmo Ai Plugins" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server doesn't publish a machine-readable tool manifest, and it doesn't expose a public endpoint we could ask. Connect the server locally to see what it exposes.
We could not run this server: its endpoint did not list its tools to an anonymous client, which usually means it asks for an API key or a sign-in. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Paste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/osmo-ai-plugins)Nothing comparable is listed yet.
v1.3.0v1.3.0 — AI Receptionist skillRelease notesv1.2.0v1.2.0 — Antigravity pluginRelease notesv1.1.0v1.1.0 — OsmO Phone Calls for every AI appRelease notesv1.0.0Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "osmo-ai-plugins" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.