How to use the Android MCP SMS Server in Chatbox

This guide explains how to connect the Ozeki Android SMS Gateway MCP server to Chatbox, 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 Chatbox, and verify that everything is working by sending a test message.

Chatbox poster
Chatbox poster

Solution: How to send SMS from Chatbox

Chatbox is connected to the Ozeki Android SMS MCP Server through the MCP protocol, where Chatbox 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 Chatbox 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.

Chatbox SMS MCP Server Overview
Send SMS from Chatbox

What is Chatbox?

Chatbox is an open-source desktop AI client that allows you to interact with multiple AI providers including OpenAI, Anthropic, and locally hosted models through a clean and intuitive interface. It supports MCP servers, enabling it to be extended with external tools such as SMS messaging, database access, and more.

What is Chatbox
What is Chatbox

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 Chatbox installed on your system. If you have not set it up yet, follow our Chatbox installation guide.

  1. Install Ozeki Android SMS Gateway
  2. Enable MCP SMS Server
  3. Chatbox SMS MCP Server Config
  4. Add the SMS MCP Server config to Chatbox
  5. Send a test SMS
  6. 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 Chatbox 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 Chatbox in the next step.

Step 3 - Chatbox SMS MCP Server Config

# Navigate to: Settings -> MCP -> Add Server -> Add Custom Server
# Replace {address} with your Ozeki Android SMS Gateway address
Name: Android SMS MCP
Type: Remote
URL: http://{address}:9531/mcp

Example prompt

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

Step 4 - Add the SMS MCP Server config to Chatbox

The following video shows how to add the Android SMS MCP server to Chatbox step-by-step. It covers opening the settings, adding a custom MCP server, testing the connection, and saving the configuration.

Open Chatbox and navigate to Settings in the interface. This is where AI provider configuration and MCP tool server integrations are managed (Figure 1).

Open settings menu
Figure 1 - Open the Chatbox settings menu

Navigate to the MCP section in the left sidebar and click the Add Server button to open the server type selection (Figure 2).

Add new MCP server
Figure 2 - Navigate to MCP and click Add Server

Select Add Custom Server from the options. This allows you to manually specify the connection details for the Ozeki Android SMS MCP server (Figure 3).

Select Add Custom MCP Server
Figure 3 - Select Add Custom Server

Fill in the server details in the registration form. Enter the server name, set the Type to Remote, and the URL to the endpoint shown in the Ozeki SMS Client app on your Android device. Click Test to verify that Chatbox can reach the MCP server (Figure 4).

Name: Android SMS MCP
Type: Remote
URL: http://{address}:9531/mcp

Enter server details and test connection
Figure 4 - Enter the server details and test the connection

After a successful connection test, the available tools exposed by the server will be listed. Review them and click Save to register the server in Chatbox (Figure 5).

View tools and save config
Figure 5 - View the available tools and save the configuration

Step 5 - Send a test SMS

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

Start a new chat in Chatbox and ensure that the Android SMS MCP server is enabled for the current session by checking the MCP tools toggle in the chat toolbar (Figure 6).

Start new chat and ensure the MCP server is enabled
Figure 6 - Start a new chat and ensure the MCP server is enabled

Type a plain language instruction in the chat prompt asking the AI to send an SMS to a specific phone number. Chatbox will call the Send SMS tool and process the request (Figure 7).

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

Instruct AI to send an SMS
Figure 7 - Instruct the AI to send an SMS message

You will see the result of the tool call in the chat window. A successful response confirms that the message has been passed to the Android gateway and queued for delivery (Figure 8).

Send SMS tool result
Figure 8 - Send SMS tool result

Step 6 - 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 Chatbox 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. Tap the Log option to view the request and response history (Figure 9).

Open logs in gateway settings

Figure 9 - Open the logs in the gateway settings

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

Select MCP tab and view logs

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

Conclusion

You have successfully configured the Ozeki Android SMS Gateway MCP server with Chatbox. 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.


More information