How to use the Android MCP SMS Server in Claude Code

This guide explains how to connect the Ozeki Android SMS Gateway MCP server to Claude Code, enabling the AI assistant to send SMS messages directly from your Android phone. By following this tutorial, you will learn how to install the Ozeki Android SMS Gateway app, enable its built-in MCP server, register the MCP endpoint in Claude Code, and verify that everything is working by sending a test message.

Claude Code poster
Claude Code poster

Solution: How to send SMS from Claude Code

Claude Code is connected to the Ozeki Android SMS MCP Server through the MCP protocol, where Claude Code is the MCP client and the Android phone is the MCP server. The Android phone is connected to the SMS service provider through a wireless mobile network connection. When an SMS is sent, it first travels from Claude Code to the Android phone through the MCP protocol, and the Android phone forwards it to the SMS service provider, which delivers it to the recipient's mobile phone.

Send SMS from Claude Code
Send SMS from Claude Code

What is Claude Code?

Claude Code is a command-line interface tool developed by Anthropic that enables developers to interact with Claude AI directly from their terminal. It provides an agentic coding experience where you can delegate programming tasks, file operations, and code generation to Claude without leaving your command-line environment.

What is Claude Code
What is Claude Code

What is an Android SMS MCP Server?

An Android SMS MCP Server is a Model Context Protocol server that runs directly on an Android smartphone and exposes SMS functionality — such as sending text messages and querying SIM subscriptions — as structured tools that any MCP-compatible AI client can call. Once installed and configured, the AI client can send real SMS messages through the phone's SIM card to any phone number, with a single tool call.

Definition what is an Android SMS MCP Server
What is an Android SMS MCP Server

Download Ozeki Android SMS Gateway

To use this solution you need to install the Android app on your Android phone.

Steps to follow

You will need Claude Code installed on your system. If you have not set it up yet, follow our Claude Code installation guide.

  1. Install Ozeki Android SMS Gateway
  2. Enable MCP SMS Server
  3. Claude Code SMS MCP Server Config
  4. Add the SMS MCP Server config to Claude Code
  5. Start Claude Code and verify connection
  6. Send a test SMS
  7. Check the SMS in the SMS Gateway logs

Step 1 - Install Ozeki Android SMS Gateway

For a full tutorial on installing the Ozeki Android SMS Gateway, check out our How to install Android SMS Client and Enable Ozeki SMS Client permissions guides.

Before you can use the MCP SMS Server, you need to install the Ozeki SMS Client on your Android device. The app will serve as the local SMS gateway that Claude Code connects to over your Wi-Fi network. Make sure both devices are on the same local network, as this is required for the HTTP connection to work.

Step 2 - Enable MCP SMS Server

For a full tutorial on enabling the MCP server in the Android app, check out our Android MCP SMS Server configuration guide.

Open the Ozeki SMS Client app on your Android device and tap the MCP tab in the bottom navigation bar. Tap the toggle switch to start the MCP server and grant any permission requests that appear, including access to SMS messages. The toggle will switch from "Stopped" to "Running" and the API endpoint URL will appear below. Copy this URL, as you will need it when configuring Claude Code in the next step.

Step 3 - Claude Code SMS MCP Server Config

# Configuration file location:
C:\Users\{User}\.claude.json

# Add the following block inside the "mcpServers" property in .claude.json
# Replace {address} with your Ozeki SMS Gateway address
"mcpServers": {
  "Ozeki Android SMS MCP": {
    "type": "http",
    "url": "http://{address}:9531/mcp"
  }
},

Example prompt

Send an SMS to +36301234567, the message should be "Hello from Claude Code".

Step 4 - Add the SMS MCP Server config to Claude Code

The following video shows how to add the Android SMS MCP server to Claude Code step-by-step.

Navigate to your user directory at C:\Users\{User}\ and open the .claude.json file in a text editor such as Notepad or Visual Studio Code. This file stores all Claude Code configuration, including any MCP servers (Figure 1).

Locate and open Claude config in text editor
Figure 1 - Locate and open the .claude.json file in a text editor

Inside the file, locate the mcpServers property. This is where all MCP server entries are registered. If the property does not exist yet, add it as a new JSON object. Then insert the Android SMS MCP server entry as shown in the code block below. Replace {address} with the IP address shown in the Ozeki SMS Client (Figure 2). 

"mcpServers": {
  "Ozeki Android SMS MCP": {
    "type": "http",
    "url": "http://{address}:9531/mcp"
  }
}

Add Android SMS MCP server to Claude Code config
Figure 2 - Add the Android SMS MCP server entry to the mcpServers block

After adding the entry, save the file and close the text editor (Figure 3).

Save config and exit text editor
Figure 3 - Save the configuration file and close the text editor

Step 5 - Start Claude Code and verify connection

Open a new terminal window by searching for Terminal in the Start menu (Figure 4).

Open a terminal window
Figure 4 - Open a new terminal window

Navigate to your working directory and type claude to start it. It will automatically attempt to connect to all MCP servers listed in the configuration file (Figure 5). 

claude

Start Claude Code
Figure 5 - Start Claude Code in the terminal

Run the /mcp command to list all connected MCP servers and their status. Verify that Ozeki Android SMS MCP appears in the list and that its status is shown as connected (Figure 6).

Run /mcp command and check connection status
Figure 6 - Run the /mcp command and verify the connection status

Step 6 - Send a test SMS

The following video shows how to send an SMS message from Claude Code using the Ozeki Android SMS MCP server step-by-step.

To send an SMS, type a plain language instruction in the prompt. For example, ask to send a message to a specific phone number. Claude Code will call the Send SMS tool and process the request (Figure 7). 

Send an SMS to +36301234567, the message should be "Hello from Claude Code".

Ask Claude Code to send an SMS message
Figure 7 - Ask Claude Code to send an SMS message

Claude Code may prompt you to allow the tool use before proceeding. This is a security confirmation to ensure you are aware that an external tool is being called on your behalf. Confirm the action to allow the AI to send the SMS (Figure 8).

Allow tool use if prompted
Figure 8 - Allow the tool use if prompted

After the tool executes, you will see the result of the Send SMS tool call in the terminal. A successful response confirms that the message has been passed to the Android gateway and queued for delivery (Figure 9).

Send SMS tool result
Figure 9 - SMS tool result

Step 7 - Check the SMS in the SMS Gateway logs

The following video shows how to check the gateway logs in the Ozeki SMS Client app step-by-step. This allows you to confirm that the SMS request from Claude Code was received and processed successfully by the Android gateway.

Open the Ozeki SMS Client app on your Android device and navigate to the Settings tab in the bottom navigation bar to access the application settings (Figure 10).

Open gateway settings

Figure 10 - Open the gateway settings on the Android device

Tap the Log option in the Settings to view the request and response history. This will take you to a screen where all recent activity handled by the gateway is recorded. (Figure 11).

Navigate to logs

Figure 11 - Navigate to the Logs section in the app

Select the MCP tab to show only MCP-related activity. Here you will see the incoming tool call requests from and the responses sent back, allowing you to confirm that the SMS was dispatched successfully (Figure 12).

Select MCP tab and view logs

Figure 12 - Select the MCP tab to view the MCP activity logs

Summary

You have successfully configured the Ozeki Android SMS Gateway MCP server with Claude Code. Your Android device is now acting as a local SMS gateway that it can communicate with over your local network, enabling text messages to be sent to any phone number using plain language prompts. All SMS traffic is routed through your Android device's mobile connection, with no cloud messaging API or third-party service required — everything runs locally on your own hardware.

More information