How to use the Android MCP SMS Server in OpenCode

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

Solution: How to send SMS from OpenCode

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

What is OpenCode?

OpenCode is an open-source, terminal-based AI coding assistant that allows developers to interact with AI models directly from the command line. It supports a wide range of AI providers and can be extended with MCP servers to add capabilities such as SMS messaging, database access, and more.

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.

Download Ozeki Android SMS Gateway

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

Download the android app: Android SMS Gateway

https://android-sms-gateway.com/p_51-download-android-sms-gateway.html

Steps to follow

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

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

Step 3 - OpenCode SMS MCP Server Config

# Configuration file location:
C:\Users\%USERPROFILE%\.config\opencode\opencode.json

# Add the following block inside the "mcp" property in config.json
# Replace {address} with your Ozeki Android SMS Gateway address
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "Ozeki Android SMS Server": {
      "type": "remote",
      "url": "http://{address}:9531/mcp",
      "enabled": true
    }
  }
}

Example prompt

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

Step 4 - Add the SMS MCP Server config to OpenCode

The following video shows how to add the Android SMS MCP server to OpenCode step-by-step. It covers navigating to the configuration folder, editing the config file, and adding the MCP server entry.

Navigate to the OpenCode configuration directory at C:\Users\%USERPROFILE%\.config\opencode\ using File Explorer. You can open this folder by typing %USERPROFILE%\.config\opencode directly into the File Explorer address bar and pressing Enter (Figure 1).

Open the opencode.json file in a text editor such as Notepad or Visual Studio Code. This file stores all OpenCode configuration, including any MCP servers (Figure 2).

Locate the mcp property in the file. If it does not exist yet, add it as a new block. Then insert the Android SMS MCP server entry as shown below. Replace {address} with the IP address shown in the Ozeki SMS Client (Figure 3).

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "Ozeki Android SMS Server": {
      "type": "remote",
      "url": "http://{address}:9531/mcp",
      "enabled": true
    }
  }
}

Step 5 - Send a test SMS

The following video shows how to send an SMS message from OpenCode using the Ozeki Android SMS MCP server step-by-step. It covers launching OpenCode from the terminal and sending a test message.

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

Navigate to your working directory and launch OpenCode from the terminal. It will automatically connect to all MCP servers listed in the configuration file, including the Ozeki Android SMS MCP server you just added (Figure 5).

Type a plain language instruction in the prompt asking the AI to send an SMS to a specific phone number. OpenCode will call the Send SMS tool exposed by the MCP server and process the request (Figure 6).

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

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 7).

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 OpenCode 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 8).

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

Final thoughts

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