AI导哈

OpenPhone短信与通话管理MCP服务器

openphone-mcp 是一个模型上下文协议（MCP）服务器，可在终端中读取短信、发送消息、查看通话记录并管理 OpenPhone/Quo 会话，适用于将企业通信能力接入 Claude Code 等 AI 助手的场景。

  • by studio-corsair
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 studio-corsair/openphone-mcp

使用说明

openphone-mcp

MCP server for OpenPhone (now Quo) — read SMS messages, list calls, send texts, and manage conversations from the terminal via the Model Context Protocol.

Tools

Tool Description
get_phone_numbers List all phone numbers in your workspace
list_messages List SMS messages for a phone number (with date/direction filters)
get_message Get a specific message by ID
send_message Send an SMS from an OpenPhone number
list_conversations List conversation threads
list_calls List call history for a phone number
get_call Get details of a specific call

Setup

1. Get an API key

Go to OpenPhone Settings > API and generate an API key.

2. Install

npm install -g openphone-mcp

Or clone and build locally:

git clone https://github.com/studio-corsair/openphone-mcp.git
cd openphone-mcp
npm install
npm run build

3. Configure Claude Code

Add to your ~/.claude.json:

{
  "mcpServers": {
    "openphone": {
      "command": "npx",
      "args": ["-y", "openphone-mcp"],
      "env": {
        "OPENPHONE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Or if installed locally:

{
  "mcpServers": {
    "openphone": {
      "command": "node",
      "args": ["/path/to/openphone-mcp/dist/index.js"],
      "env": {
        "OPENPHONE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Usage Examples

Read recent SMS messages:

"Show me my recent text messages on OpenPhone"

Read verification codes:

"What's the latest SMS I received?"

Send a text:

"Send a text to +15551234567 from my OpenPhone number saying 'On my way'"

Check call history:

"Show me my recent calls"

API Details

  • Base URL: https://api.openphone.com/v1
  • Auth: API key in Authorization header (no Bearer prefix)
  • Rate limit: 10 requests/second per API key
  • Docs: quo.com/docs/api-reference

License

MIT

相关 MCP