How to set up an SMS MCP server to send SMS from Codex

This guide walks you through sending an SMS message from Codex using the Ozeki SMS MCP server. By following this tutorial, you will learn how to verify the MCP server connection, instruct the AI agent to send an SMS in plain language, and confirm that the message was delivered through the gateway logs.

What is an MCP tool call?

An MCP (Model Context Protocol) tool call is how an AI model communicates with external systems. When the AI needs to perform an action such as sending an SMS, it sends a structured request to the appropriate MCP server, which processes it and returns the result back to the model.

Overview
Overview

Example prompt

Send an SMS to +36301111111, the message should be "Hello from Codex".

Steps to follow

We assume Ozeki SMS Gateway is already installed on your system, you have created an MCP user account with an API key, and you have already configured the Ozeki SMS MCP server in Codex.

  1. Verify the MCP server connection
  2. Use the Send SMS tool
  3. View the transaction in logs

Video tutorial

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

Step 1 - Verify the MCP server connection

Before sending a message, run the /mcp command in Codex to confirm that the Ozeki MCP server is listed and its status shows as connected (Figure 1).

Verify SMS MCP server connection in Codex
Figure 1 - Verify the Ozeki SMS MCP server connection status

Step 2 - Use the Send SMS tool

In the Codex prompt, type your SMS request in plain language and press Enter. The AI agent will interpret the request and invoke the appropriate MCP tool to deliver the message (Figure 2).

Send an SMS to +36301111111, the message should be "Hello from Codex".

Instruct the AI agent to send an SMS in Codex
Figure 2 - Instruct the AI agent to send an SMS using a plain language prompt

Codex may ask for your approval before invoking the SMS tool. Review the proposed tool call and confirm to allow the AI agent to proceed (Figure 3).

Approve tool use if prompted in Codex
Figure 3 - Review and approve the tool use request

Once the tool has been executed, the result will appear in the Codex terminal. A successful response confirms that the message was submitted to the gateway and handed off for delivery (Figure 4).

Send SMS tool result in Codex
Figure 4 - The SMS tool result appears in the Codex terminal

Step 3 - View the transaction in logs

Open Ozeki SMS Gateway in your browser and navigate to the MCP user details page by clicking on the MCP user entry in the Users and applications panel (Figure 5).

Open MCP user details in SMS Gateway
Figure 5 - Open the MCP user details in Ozeki SMS Gateway

In the MCP user event log, you should see an entry for the outgoing message, including the recipient number and message text, confirming that it was successfully processed by the gateway (Figure 6).

View transaction in event logs
Figure 6 - Verify the sent message in the MCP user event logs

Conclusion

You have successfully sent an SMS message from Codex using the Ozeki SMS MCP server. The AI agent running in Codex can now deliver SMS messages to any phone number simply by being asked to do so in plain language, making it easy to add mobile messaging to any Codex workflow.


More information