How to use the Android MCP SMS Server in AnythingLLM

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

AnythingLLM poster
AnythingLLM poster

Solution: How to send SMS from AnythingLLM

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

What is AnythingLLM?

AnythingLLM is an open-source, full-stack desktop and web application that allows you to chat with your documents and use AI agents powered by local or cloud-based large language models. It supports MCP servers through its Agent Skills configuration, enabling it to be extended with external tools such as SMS messaging, database access, and more.

What is AnythingLLM
What is AnythingLLM

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

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

Step 3 - AnythingLLM SMS MCP Server Config

# Navigate to: Application Settings -> Agent Skills -> MCP Servers
# Replace {address} with your Ozeki Android SMS Gateway address
{
  "mcpServers": {
    "ozeki-sms-mcp": {
      "type": "streamable",
      "url": "http://{address}:9531/mcp"
    }
  }
}

Example prompt

@agent Send an SMS to +36301234567, the message should be "Hello from AnythingLLM".

Step 4 - Add the SMS MCP Server config to AnythingLLM

The following video shows how to add the Android SMS MCP server to AnythingLLM step-by-step. It covers opening the Agent Skills settings, editing the MCP configuration file, and verifying the connection to the server.

Open AnythingLLM and navigate to Application Settings by clicking the settings icon in the bottom left corner of the interface (Figure 1).

Open AnythingLLM settings
Figure 1 - Open the AnythingLLM application settings

Select Agent Skills from the settings menu, then scroll down to the MCP Servers section and click Edit MCP Config to open the MCP configuration file in a text editor (Figure 2).

Navigate to Agent Skills and click Edit MCP Config
Figure 2 - Navigate to Agent Skills and click Edit MCP Config

Add the Ozeki Android SMS MCP server entry to the configuration file as shown below. Replace {address} with the IP address shown in the Ozeki SMS Client app on your Android device (Figure 3).

{
  "mcpServers": {
    "ozeki-sms-mcp": {
      "type": "streamable",
      "url": "http://{address}:9531/mcp"
    }
  }
}

Add Ozeki SMS MCP to config
Figure 3 - Add the Ozeki SMS MCP server entry to the config

Save the configuration file and close the text editor (Figure 4).

Save config and close text editor
Figure 4 - Save the configuration file and close the text editor

Back in the AnythingLLM Agent Skills settings, click the Refresh button in the MCP Servers section to reload the configuration and connect to the newly registered server (Figure 5).

Refresh MCP server list in AnythingLLM
Figure 5 - Refresh the MCP server list in AnythingLLM

Verify that ozeki-sms-mcp appears in the MCP server list along with its available tools. This confirms that AnythingLLM has successfully connected to the Android gateway and is ready to use the Send SMS tool (Figure 6).

View Ozeki SMS MCP and tools
Figure 6 - View the registered Ozeki SMS MCP server and its tools

Step 5 - Send a test SMS

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

Open a workspace chat in AnythingLLM and start an agent session by typing @agent at the beginning of your message. This switches the chat into agent mode, where MCP tools are available (Figure 7).

Start agent session
Figure 7 - Start an agent session in the workspace chat

Type a plain language instruction asking the AI agent to send an SMS to a specific phone number. AnythingLLM will call the Send SMS tool and process the request (Figure 8).

@agent Send an SMS to +36301234567, the message should be "Hello from AnythingLLM".

Ask AI to send an SMS message
Figure 8 - Ask the AI agent to send an SMS message

You will see the result of the Send SMS 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 9).

Send SMS tool result
Figure 9 - 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 AnythingLLM 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 10).

Open logs in gateway settings

Figure 10 - 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 AnythingLLM and the responses sent back, allowing you to confirm that the SMS was dispatched successfully (Figure 11).

Select MCP tab and view logs

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

Summary

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