Skip to main content
Glama
OsmO Phone Calls

OsmO Phone Calls

Official
by getosmo
README.md
<p align="center">
  <img src="assets/logo.png" alt="OsmO logo" width="96" height="96">
</p>

<h1 align="center">OsmO Phone Calls &amp; AI Receptionist</h1>

<p align="center">
  <b>Let your AI make real phone calls for you.</b><br>
  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 <b>AI phone receptionist</b>: it answers
  calls to your number, screens spam and takes messages and bookings.
</p>

<p align="center">
  <a href="https://registry.modelcontextprotocol.io/v0.1/servers/app.getosmo%2Fphone-calls/versions/latest"><img alt="MCP Registry: app.getosmo/phone-calls" src="https://img.shields.io/badge/MCP_Registry-app.getosmo%2Fphone--calls-blue"></a>
  <a href="https://glama.ai/mcp/connectors/app.getosmo/phone-calls"><img alt="OsmO Phone Calls on Glama" src="https://glama.ai/mcp/connectors/app.getosmo/phone-calls/badges/score.svg"></a>
  <a href="https://chatgpt.com/plugins/plugin_asdk_app_6ad0ed3277688191b90bd9dafe5d6cd9"><img alt="ChatGPT plugin directory" src="https://img.shields.io/badge/ChatGPT-plugin_directory-10a37f"></a>
  <a href="https://clawhub.ai/getosmo/osmo-phone-calls"><img alt="ClawHub: getosmo/osmo-phone-calls" src="https://img.shields.io/badge/ClawHub-osmo--phone--calls-orange"></a>
  <a href="https://aiagentslisting.com/mcp/osmo-ai-plugins"><img alt="Osmo Ai Plugins on AI Agents Listing" src="https://aiagentslisting.com/osmo-ai-plugins/badge.svg?claim=2bc13b0547d015ab02a54ca36da2271b"></a>
  <a href="https://clawhub.ai/getosmo/osmo-ai-receptionist"><img alt="ClawHub: getosmo/osmo-ai-receptionist" src="https://img.shields.io/badge/ClawHub-osmo--ai--receptionist-orange"></a>
  <a href="https://mcp.so/servers/osmo-phone-calls"><img alt="OsmO on mcp.so" src="https://img.shields.io/badge/mcp.so-verified-2563eb"></a>
  <a href="https://cursor.directory/plugins/osmo-ai-phone-calls-ai-receptionist"><img alt="OsmO on cursor.directory" src="https://img.shields.io/badge/cursor.directory-plugin-000000"></a>
  <a href="LICENSE"><img alt="License: MIT (client files)" src="https://img.shields.io/github/license/getosmo/osmo-ai-plugins"></a>
</p>

<p align="center">
  <a href="https://cursor.com/en/install-mcp?name=osmo&config=eyJ1cmwiOiJodHRwczovL2FwaS5nZXRvc21vLmFwcC9tY3AifQ=="><img alt="Install in Cursor" src="https://custom-icon-badges.demolab.com/badge/Install_in_Cursor-000000?style=for-the-badge&logo=cursor-ai-white"></a>
  <a href="https://vscode.dev/redirect/mcp/install?name=osmo&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.getosmo.app%2Fmcp%22%7D"><img alt="Install in VS Code" src="https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white"></a>
  <a href="https://insiders.vscode.dev/redirect/mcp/install?name=osmo&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.getosmo.app%2Fmcp%22%7D&quality=insiders"><img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=for-the-badge&logo=visualstudiocode&logoColor=white"></a>
  <a href="https://chatgpt.com/plugins/plugin_asdk_app_6ad0ed3277688191b90bd9dafe5d6cd9"><img alt="Add to ChatGPT" src="https://img.shields.io/badge/Add_to-ChatGPT-10a37f?style=for-the-badge"></a>
</p>

```
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.*

<table>
  <tr>
    <td width="50%"><img src="assets/cards/osmo-card-1-multi-call.png" alt="OsmO call card: five restaurants called at once, one connected, one in a call, two not reached, one not placed"><br><sub>Up to five calls on one card</sub></td>
    <td width="50%"><img src="assets/cards/osmo-card-2-call-result.png" alt="OsmO call card after the call: table booked, with Call again and Schedule buttons"><br><sub>The result as soon as the call ends</sub></td>
  </tr>
  <tr>
    <td width="50%"><img src="assets/cards/osmo-card-3-places.png" alt="OsmO places card: three restaurants with address, number, rating and a Call button"><br><sub>Places to call (Claude)</sub></td>
    <td width="50%"><img src="assets/cards/osmo-card-4-call-details.png" alt="OsmO call details card: summary, time, length, reason, recording and Call again"><br><sub>A call's details (Claude)</sub></td>
  </tr>
  <tr>
    <td width="50%"><img src="assets/cards/osmo-card-5-my-assistant.png" alt="OsmO assistant card: current assistant with photo and language, other assistants with Use buttons"><br><sub>Switch your assistant (Claude)</sub></td>
    <td width="50%"></td>
  </tr>
</table>

**New users get 50 free credits** at [getosmo.app/login](https://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

- [What it looks like](#what-it-looks-like)
- [How it works](#how-it-works)
- [Connect your AI](#connect-your-ai)
- [Example prompts](#example-prompts)
- [What it can and can't do](#what-it-can-and-cant-do)
- [Cost](#cost)
- [Safety and privacy](#safety-and-privacy)
- [Tools](#tools)
- [What's in this repo](#whats-in-this-repo)
- [Authentication and network](#authentication-and-network)
- [Support, security and license](#support-security-and-license)

## How it works

```mermaid
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.

| App | How to connect | Guide |
|---|---|---|
| **ChatGPT** | Plugins → search **OsmO** → Connect, or open the [OsmO listing](https://chatgpt.com/plugins/plugin_asdk_app_6ad0ed3277688191b90bd9dafe5d6cd9) | [guide](https://getosmo.app/ai-calls/chatgpt-phone-calls-setup) |
| **Claude** (web, desktop, mobile) | Customize → Connectors → **+ Add** → Add custom connector → URL `https://api.getosmo.app/mcp` | [guide](https://getosmo.app/ai-calls/claude-phone-calls-setup) |
| **Claude Code** | `claude mcp add --transport http osmo https://api.getosmo.app/mcp`, then `/mcp` to sign in. Or the plugin (MCP + skill), [below](#claude-code-plugin) | [guide](https://getosmo.app/ai-calls/claude-phone-calls-setup) |
| **Cursor** | Click **Install in Cursor** above, or add [`mcp.json`](mcp.json) to `.cursor/mcp.json` or `~/.cursor/mcp.json` | [guide](https://getosmo.app/ai-calls/cursor-phone-calls-setup) |
| **VS Code** (GitHub Copilot) | Click **Install in VS Code** above, or run **MCP: Add Server** and choose HTTP, or add the JSON [below](#vs-code) | [guide](https://getosmo.app/ai-calls/copilot-phone-calls-setup) |
| **Codex** (CLI, IDE) | `codex mcp add osmo --url https://api.getosmo.app/mcp`, then `codex mcp login osmo`. Or the plugin, [below](#codex-plugin) | [guide](https://getosmo.app/ai-calls/codex-phone-calls-setup) |
| **Gemini CLI** | `gemini extensions install https://github.com/getosmo/osmo-ai-plugins`, then `/mcp auth osmo` | [guide](https://getosmo.app/ai-calls/gemini-phone-calls-setup) |
| **Antigravity** | Install the plugin from this repo (`.antigravity-plugin/`, [`mcp_config.json`](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](https://getosmo.app/ai-calls/grok-phone-calls-setup) |
| **Grok Build** | `grok mcp add --transport http osmo https://api.getosmo.app/mcp` | [guide](https://getosmo.app/ai-calls/grok-build-phone-calls-setup) |
| **Perplexity** (Pro, Max, Enterprise) | Plugins → Add custom → Add MCP connector → Remote → URL `https://api.getosmo.app/mcp` | [guide](https://getosmo.app/ai-calls/perplexity-phone-calls-setup) |
| **OpenClaw** | `openclaw skills install @getosmo/osmo-phone-calls`, then the two commands [below](#openclaw) | [ClawHub](https://clawhub.ai/getosmo/osmo-phone-calls) |
| **Hermes** | add the YAML [below](#hermes), 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`](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](https://github.com/getosmo/osmo-ai-plugins/issues).

### 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@osmo
```

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

```sh
codex plugin marketplace add getosmo/osmo-ai-plugins
codex plugin add osmo@osmo
codex mcp login osmo
```

### VS Code

`.vscode/mcp.json` (workspace) or your user `mcp.json`:

```json
{
  "servers": {
    "osmo": {
      "type": "http",
      "url": "https://api.getosmo.app/mcp"
    }
  }
}
```

### Cursor

`~/.cursor/mcp.json` or `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "osmo": {
      "url": "https://api.getosmo.app/mcp"
    }
  }
}
```

### OpenClaw

```sh
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 osmo
```

### Hermes

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

```yaml
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):

```json
{
  "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](https://apps.apple.com/us/app/osmo-ai-phone-assistant/id6761623744),
[Android](https://play.google.com/store/apps/details?id=com.osmo.aicallassistant)):

- 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](https://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](https://apps.apple.com/us/app/osmo-ai-phone-assistant/id6761623744), [Android](https://play.google.com/store/apps/details?id=com.osmo.aicallassistant)) |

If your free credits run out, the tools say so and point you to the OsmO app
([getosmo.app/app](https://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](https://getosmo.app/privacy) and [terms](https://getosmo.app/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? |
|---|---|---|
| `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` | Receptionist settings: pause the AI, who is put through live, alerts, VIP and block lists | update: yes, after you confirm |
| `get_assistant` / `update_assistant` | 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 |
| `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); read-only | no |
| `get_connections` | Whether Google Calendar, Calendly and Google Drive are connected (status only) | no |
| `list_bookings` | Bookings your call assistant took or cancelled, upcoming or past | 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 |

## 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 |
|---|---|
| [`skills/osmo-phone-calls/SKILL.md`](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](https://clawhub.ai/getosmo/osmo-phone-calls). |
| [`skills/osmo-ai-receptionist/SKILL.md`](skills/osmo-ai-receptionist/SKILL.md) | 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](https://clawhub.ai/getosmo/osmo-ai-receptionist). |
| [`skills/osmo-call-screening/SKILL.md`](skills/osmo-call-screening/SKILL.md) | 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](https://clawhub.ai/getosmo/osmo-call-screening). |
| [`skills/osmo-customer-service-calls/SKILL.md`](skills/osmo-customer-service-calls/SKILL.md) | 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](https://clawhub.ai/getosmo/osmo-customer-service-calls). |
| [`skills/osmo-book-by-phone/SKILL.md`](skills/osmo-book-by-phone/SKILL.md) | Agent Skill for booking by phone: restaurant reservations and appointments, made, moved or cancelled by a call. Published on [ClawHub](https://clawhub.ai/getosmo/osmo-book-by-phone). |
| [`.claude-plugin/`](.claude-plugin) | Claude Code plugin + marketplace (MCP server + skill) |
| [`.codex-plugin/plugin.json`](.codex-plugin/plugin.json) | Codex plugin (MCP server + skill) |
| [`.cursor-plugin/plugin.json`](.cursor-plugin/plugin.json), [`mcp.json`](mcp.json) | Cursor plugin and MCP config |
| [`gemini-extension.json`](gemini-extension.json), [`GEMINI.md`](GEMINI.md) | Gemini CLI extension |
| [`.antigravity-plugin/plugin.json`](.antigravity-plugin/plugin.json), [`mcp_config.json`](mcp_config.json) | Antigravity plugin |
| [`llms-install.md`](llms-install.md) | Install steps written for AI agents (Cline and others) |
| [`server.json`](server.json) | Official 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

- Help: [getosmo.app/support](https://getosmo.app/support.html) or **team@getosmo.app**
- Security reports: see [SECURITY.md](SECURITY.md)
- Improving a client config or the skill: see [CONTRIBUTING.md](CONTRIBUTING.md)
- License: MIT for the files in this repo ([LICENSE](LICENSE)). Using OsmO is governed by the
  [OsmO terms](https://getosmo.app/terms) and [privacy policy](https://getosmo.app/privacy).

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