Setup Guide

Connect PhoneMCP to your AI assistant

ChatGPT Claude Gemini CLI

ChatGPT Setup

Connect PhoneMCP to ChatGPT using Model Context Protocol (MCP). Requires ChatGPT Plus, Pro, or Team subscription.

1Install PhoneMCP Android App

Download and install the PhoneMCP app from the Google Play Store on your Android phone.

Open the Play Store and search for "PhoneMCP"
Install the app and launch it
Sign in with your Google account
Grant SMS permissions when prompted

2Get Your PhoneMCP Server URL

After signing in to the PhoneMCP app, you'll see your unique server URL. You'll need this to connect ChatGPT.

Note: Your server URL is unique to your account and looks like: https://api.phone-mcp.com/user/YOUR_ID

3Add PhoneMCP to ChatGPT

Open ChatGPT on your desktop or mobile device:

Go to Settings → Integrations → Model Context Protocol
Click "Add MCP Server"
Enter a name: "PhoneMCP"
Paste your PhoneMCP server URL
Save the configuration

4Start Using PhoneMCP

You're all set! Try sending a test message:

Send a text to +1234567890 saying "Hello from PhoneMCP!"

ChatGPT will use PhoneMCP to send the message from your Android phone.

Claude Setup

Connect PhoneMCP to Claude Desktop using Model Context Protocol (MCP). Requires Claude Pro subscription.

1Install PhoneMCP Android App

Download and install the PhoneMCP app from the Google Play Store on your Android phone.

Open the Play Store and search for "PhoneMCP"
Install the app and launch it
Sign in with your Google account
Grant SMS permissions when prompted

2Install Claude Desktop

Download and install Claude Desktop app from Anthropic's website.

Note: Claude Desktop is required for MCP support. The web version of Claude does not support MCP servers yet.

3Install PhoneMCP MCP Server

Install the PhoneMCP MCP server package using npm:

npm install -g phonemcp-mcp-server

Or install locally in your Claude MCP directory.

4Configure Claude Desktop

Open Claude's MCP configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Add the PhoneMCP server configuration:

{
  "mcpServers": {
    "phonemcp": {
      "command": "phonemcp-mcp-server",
      "args": ["--email", "your-google-email@gmail.com"]
    }
  }
}

Important: Use the same Google email you used to sign in to the PhoneMCP Android app.

5Restart Claude Desktop

Close and reopen Claude Desktop to load the PhoneMCP MCP server.

You should see PhoneMCP appear in the MCP servers list (look for the 🔌 icon).

6Start Using PhoneMCP

You're all set! Try sending a test message:

Send a text to +1234567890 saying "Hello from PhoneMCP!"

Claude will use PhoneMCP to send the message from your Android phone.

Gemini CLI Setup

Connect PhoneMCP to Gemini CLI using Model Context Protocol (MCP). Requires Gemini Advanced subscription.

1Install PhoneMCP Android App

Download and install the PhoneMCP app from the Google Play Store on your Android phone.

Open the Play Store and search for "PhoneMCP"
Install the app and launch it
Sign in with your Google account
Grant SMS permissions when prompted

2Install Gemini CLI

Install the Gemini CLI tool:

npm install -g @google/generative-ai-cli

Authenticate with your Google account:

gemini auth login

3Install PhoneMCP MCP Server

Install the PhoneMCP MCP server package:

npm install -g phonemcp-mcp-server

4Configure Gemini CLI for MCP

Add PhoneMCP to your Gemini CLI MCP configuration:

gemini mcp add phonemcp --command "phonemcp-mcp-server" --args "--email your-google-email@gmail.com"

Important: Use the same Google email you used to sign in to the PhoneMCP Android app.

5Start Using PhoneMCP

Start a Gemini CLI session with MCP support:

gemini chat --mcp

Try sending a test message:

Send a text to +1234567890 saying "Hello from PhoneMCP!"

Gemini will use PhoneMCP to send the message from your Android phone.