How to set up an SMS MCP server to receive SMS in LobeChat

This guide walks you through retrieving incoming SMS messages in LobeChat using the Ozeki SMS MCP server. By following this tutorial, you will learn how to enable the Ozeki SMS MCP skill in the chat interface, ask the AI agent to list incoming messages in plain language, and confirm the transaction through the gateway logs.

What is an MCP tool call?

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

Overview
Overview

Example prompt

List all 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 LobeHub.

  1. Enable the Ozeki SMS MCP skill
  2. Use the list incoming messages tool
  3. View the transaction in logs

Video tutorial

The following video shows how to retrieve incoming SMS messages in LobeHub using the Ozeki SMS MCP server step-by-step.

Step 1 - Enable the Ozeki SMS MCP skill

Open a new conversation in LobeChat and locate the skills selector in the chat interface. Enable the Ozeki MCP skill so that the AI agent can invoke it during the conversation (Figure 1).

Enable Ozeki SMS MCP skill in LobeHub chat
Figure 1 - Enable the Ozeki SMS MCP skill in the LobeHub chat

Step 2 - Use the list incoming messages tool

In the chat input, type your request in plain language and press the Send button. The AI agent will interpret the request and invoke the appropriate MCP tool to retrieve the messages from the gateway inbox (Figure 2).

List all incoming SMS messages.

Ask AI agent to list incoming messages in LobeHub
Figure 2 - Ask the AI agent to list incoming SMS messages

The result will appear in the chat, displaying the list of incoming messages. Each entry includes the sender number, recipient number and the message text (Figure 3).

List incoming messages tool result in LobeHub
Figure 3 - The incoming messages tool result appears in the LobeHub chat

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

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

In the MCP user event log, you should see an entry for the incoming message retrieval request as well as the response, confirming that the API key authentication, tool call, and data retrieval were all processed correctly by the gateway (Figure 5).

View transaction in event logs
Figure 5 - Verify the transaction in the MCP user event logs

Final thoughts

You have successfully retrieved incoming SMS messages in LobeHub using the Ozeki SMS MCP server. The AI agent running in LobeHub 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 LobeHub workflow.


More information