How to use the Ozeki SMS MCP Server in Claude Code

This guide explains how to connect the Ozeki SMS Gateway MCP server to Claude Code, enabling the AI assistant to send and receive SMS messages directly from your computer through your own on-premises SMS gateway. By following this tutorial, you will learn how to install the Ozeki SMS Gateway, create an MCP user account and generate an API key for authentication, register the MCP endpoint in Claude Code, and verify that everything is working by sending and receiving test messages.

Solution: How to send SMS from Claude Code

Claude Code is connected to the Ozeki SMS MCP Server through the MCP protocol, where Claude Code acts as the MCP client and Ozeki SMS Gateway acts as the MCP server. Ozeki SMS Gateway is installed on your local machine or server and connects to the SMS service provider over the internet. When an SMS is sent, it first travels from Claude Code to the Ozeki SMS Gateway as an MCP tool call, and the gateway 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

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 SMS Gateway
  2. Install an SMPP Client and create MCP User
  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 gateway logs

Step 1 - Install Ozeki SMS Gateway

For a full tutorial on installing the Ozeki Android SMS Gateway, check out our How to install Ozeki SMS Gateway on Windows guide.

Before you can use the MCP SMS Server, you need to install the Ozeki SMS Gateway on your system. The software will serve as the local SMS gateway that Claude Code connects to over your network.

Step 2 - Install an SMPP Client and create MCP User

For full tutorials on installing an SMPP Client and creating an MCP User, check out our SMPP Client Connection and Create an MCP User guides.

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.

More information