How to configure the Ozeki SMS MCP Server in AnythingLLM

This guide walks you through integrating the Ozeki SMS MCP Server with AnythingLLM, an open-source desktop application that combines chat, document management, and AI agent capabilities. By following this tutorial, you will learn how to add the Ozeki SMS Gateway to the MCP server configuration file, and verify that the SMS tools are available.

What is an MCP server?

An MCP (Model Context Protocol) server exposes tools that an AI model can call during a conversation. In this setup, the Ozeki SMS MCP Server provides SMS tools such as sending messages and listing incoming SMS. AnythingLLM connects to the MCP server over HTTP using the configured URL and API key, giving the AI agent the ability to interact with the mobile network through your gateway.

Overview
Overview

AnythingLLM MCP server configuration

Application Settings -> Agent Skills -> MCP Servers -> Edit MCP Config

# Add the following block to the configuration file
# Replace {address} with your Ozeki SMS Gateway IP
# Replace the Bearer token with the API key generated for your MCP user account
{
  "mcpServers": {
    "Ozeki": {
      "type": "streamable",
      "url": "http://{address}:9529/mcp",
      "headers": {
        "Authorization": "Bearer abcd1234"
      }
    }
  }
}

Steps to follow

We assume Ozeki SMS Gateway is already installed on your system and you have already created an MCP user account with an API key. You will also need AnythingLLM installed on your system; you can follow our How to set up AnythingLLM with Ozeki AI Gateway guide.

  1. Navigate to Agent Skills in AnythingLLM
  2. Add the SMS MCP Server to the config
  3. Refresh server list and verify connection

Video tutorial

The following video shows how to add the Ozeki SMS MCP Server to AnythingLLM step-by-step.

Step 1 - Navigate to Agent Skills in AnythingLLM

Open AnythingLLM and click the settings icon in the bottom right to open the application settings (Figure 1).

Open AnythingLLM settings
Figure 1 - Open the AnythingLLM settings

In the settings menu, navigate to Agent Skills, locate the MCP Servers section and click the Edit MCP Config button. This will open the underlying JSON configuration file where MCP server entries are stored (Figure 2).

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

Step 2 - Add the SMS MCP Server to the config

In the configuration file, add the Ozeki SMS MCP Server entry inside the mcpServers object as shown below. Replace {address} with the IP address of your Ozeki SMS Gateway installation, and replace the Bearer token with the API key you generated for your MCP user account (Figure 3). 

{
  "mcpServers": {
    "Ozeki": {
      "type": "streamable",
      "url": "http://{address}:9529/mcp",
      "headers": {
        "Authorization": "Bearer ozkey-abc123"
      }
    }
  }
}

Add Ozeki SMS MCP to config
Figure 3 - Add the Ozeki SMS MCP Server entry to the configuration file

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

Step 3 - Refresh server list and verify connection

Return to the Agent Skills page and click the refresh button to reload the MCP server list. This tells AnythingLLM to re-read the configuration file and attempt to connect to any newly added server entries (Figure 5).

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

After refreshing, the Ozeki MCP server should appear in the list along with the SMS tools it exposes. This confirms that AnythingLLM has successfully connected to your Ozeki SMS Gateway and the AI agent is ready to send and receive SMS messages (Figure 6).

View Ozeki SMS MCP and tools
Figure 6 - The Ozeki SMS MCP Server and its tools are listed in AnythingLLM

Summary

You have successfully configured the Ozeki SMS MCP Server in AnythingLLM. The AI agent running in AnythingLLM can now send and receive SMS messages through your gateway using plain language prompts, making it straightforward to add mobile messaging capabilities to your AnythingLLM workflows.

More information