Repository avatar
AI Tools
v1.0.0
active

ai-receptionist

app.getosmo/ai-receptionist

AI phone receptionist for your number: answers calls, screens spam, takes messages and bookings.

Documentation

OsmO logo

OsmO Phone Calls & AI Receptionist

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.

MCP Registry: app.getosmo/phone-calls OsmO Phone Calls on Glama ChatGPT plugin directory ClawHub: getosmo/osmo-phone-calls Osmo Ai Plugins on AI Agents Listing ClawHub: getosmo/osmo-ai-receptionist OsmO on mcp.so OsmO on cursor.directory License: MIT (client files)

Install in Cursor Install in VS Code Install in VS Code Insiders Add to ChatGPT

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.

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 said

There 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.

AppHow to connectGuide
ChatGPTPlugins → search OsmO → Connect, or open the OsmO listingguide
Claude (web, desktop, mobile)Customize → Connectors → + Add → Add custom connector → URL https://api.getosmo.app/mcpguide
Claude Codeclaude mcp add --transport http osmo https://api.getosmo.app/mcp, then /mcp to sign in. Or the plugin (MCP + skill), belowguide
CursorClick Install in Cursor above, or add mcp.json to .cursor/mcp.json or ~/.cursor/mcp.jsonguide
VS Code (GitHub Copilot)Click Install in VS Code above, or run MCP: Add Server and choose HTTP, or add the JSON belowguide
Codex (CLI, IDE)codex mcp add osmo --url https://api.getosmo.app/mcp, then codex mcp login osmo. Or the plugin, belowguide
Gemini CLIgemini extensions install https://github.com/Mountainheads-Private-limited/osmo-ai-plugins, then /mcp auth osmoguide
AntigravityInstall 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/mcpguide
Grok Buildgrok mcp add --transport http osmo https://api.getosmo.app/mcpguide
Perplexity (Pro, Max, Enterprise)Plugins → Add custom → Add MCP connector → Remote → URL https://api.getosmo.app/mcpguide
OpenClawopenclaw skills install @getosmo/osmo-phone-calls, then the two commands belowClawHub
Hermesadd the YAML below, then hermes mcp login osmo—
Cline, Windsurf, OpenCode, any MCP clientadd 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.

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 Mountainheads-Private-limited/osmo-ai-plugins
/plugin install osmo@osmo

On 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.

Codex plugin

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

VS 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
openclaw mcp set osmo '{"url":"https://api.getosmo.app/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login osmo

Hermes

~/.hermes/config.yaml, then hermes mcp login osmo:

mcp_servers:
  osmo:
    url: "https://api.getosmo.app/mcp"
    auth: oauth

OpenCode

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.

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, and list or cancel scheduled calls.
  • 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 call3 credits, however long it is
A call nobody answersfree
Contacts, scheduled calls, screeningneed an OsmO app plan. Signing in to the app ends any free credits you have left.
After the free creditskeep 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).

Safety and privacy

  • You confirm every call. 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.
  • 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.app over 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.

ToolWhat it doesChanges something?
place_callCall 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_statusProgress and result of a call OsmO placedno
cancel_scheduled_callCancel a call booked for later (OsmO app plan)yes, after you confirm
list_scheduled_callsCalls booked for later (OsmO app plan)no
list_calls / list_recent_callsYour calls, newest first, with summariesno
get_callOne call: summary, transcript, recording linkno
find_businessBusinesses near a place, with phone numbers (Google Maps listings)no
find_customer_careA company's customer-care numbers in your countryno
find_contactPeople in your call historyno
search_contactsYour phone book (contacts synced by the OsmO app)no
get_settings / update_settingsReceptionist settings: pause the AI, who is put through live, alerts, VIP and block listsupdate: yes, after you confirm
get_assistant / update_assistantWhich 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
list_rules / add_rule / update_rule / delete_ruleCall-screening rulesadd, update, delete: yes, after you confirm
get_factsWhat your assistant tells callers (website, documents); read-onlyno
get_connectionsWhether Google Calendar, Calendly and Google Drive are connected (status only)no
list_bookingsBookings your call assistant took or cancelled, upcoming or pastno
list_chats / get_chatYour chats with OsmO in the appno
get_account_statusCredits left (free-credit accounts), or plan, OsmO number and forwarding status (app accounts)no
osmo_supportHelp answers: forwarding codes, plans, privacyno
osmo_helpWhat this integration can and can't dono

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.

PathFor
skills/osmo-phone-calls/SKILL.mdAgent 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.mdAgent 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.
.claude-plugin/Claude Code plugin + marketplace (MCP server + skill)
.codex-plugin/plugin.jsonCodex plugin (MCP server + skill)
.cursor-plugin/plugin.json, mcp.jsonCursor plugin and MCP config
gemini-extension.json, GEMINI.mdGemini CLI extension
.antigravity-plugin/plugin.json, mcp_config.jsonAntigravity plugin
llms-install.mdInstall steps written for AI agents (Cline and others)
server.jsonOfficial MCP Registry metadata (app.getosmo/phone-calls)

Authentication and network

  • 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: discovery
  • https://api.getosmo.app/mcp/oauth/authorize, /token, /register, /revoke: OAuth 2.1 with PKCE and dynamic client registration
  • https://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

If OsmO makes a call you'd rather not make yourself, a ⭐ on this repo helps other people find it.

No installation packages available.

Remote