How to receive SMS in Claude Code

This guide walks you through retrieving incoming SMS messages directly from Claude Code using the Ozeki SMS MCP server. By following this tutorial, you will learn how to launch Claude Code, ask it to list incoming messages in plain language, and verify the transaction 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 or retrieve data, such as querying a database, calling an API, or reading a file, it sends a structured request to the appropriate MCP server, which processes it and returns the result.

Example prompt

List all my incoming SMS messages.

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 Claude Code.

Launch Claude Code
Use the list incoming messages tool
Verify the transaction in logs

How to receive SMS in Claude Code video

The following video shows how to retrieve incoming SMS messages from Claude Code using the Ozeki SMS MCP server step-by-step.

Step 1 - Launch Claude Code

Open a terminal window and navigate to your working directory. Type claude and press Enter to start Claude Code (Figure 1).

Launch Claude Code from terminal — Figure 1 - Launch Claude Code from the terminal

Step 2 - Use the list incoming messages tool

In the Claude Code prompt, type your request in plain language and press Enter. Claude Code will interpret the request and invoke the appropriate MCP tool to retrieve the messages from the gateway inbox (Figure 2).

List all my incoming SMS messages.

Ask AI to list messages — Figure 2 - Ask Claude Code to list incoming SMS messages

Claude Code will display the result returned by the Ozeki SMS MCP server. You should see the list of incoming messages, each with the sender number, message text, and timestamp confirming when it was received (Figure 3).

List incoming messages tool result — Figure 3 - Claude Code displays the incoming messages tool result

Step 3 - Verify the transaction in logs

Open Ozeki SMS Gateway in your browser and navigate to the event log of your MCP user. You should see a log entry for the incoming message retrieval request, confirming that the API key authentication and tool call were processed correctly by the gateway (Figure 4).

Check transaction in MCP user event logs — Figure 4 - Verify the transaction in the MCP user event logs

Final thoughts

You have successfully retrieved incoming SMS messages from Claude Code using the Ozeki SMS MCP server. Claude Code can now list incoming messages from your gateway simply by being asked to do so in plain language, making it easy to add SMS inbox access to any Claude Code workflow.