How to configure the Ozeki SMS MCP Server in ZeroClaw

This guide walks you through integrating the Ozeki SMS MCP Server with ZeroClaw, an AI agent platform that lets you build and run autonomous workflows from your desktop. By following this tutorial, you will learn how to edit the ZeroClaw configuration file, add the Ozeki SMS Gateway as an MCP server, and verify the connection from the dashboard.

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. ZeroClaw connects to the MCP server over HTTP using the configured URL and Bearer token.

ZeroClaw SMS MCP Server Overview
ZeroClaw SMS MCP Server Overview

ZeroClaw MCP server configuration

# Configuration file location:
%USERPROFILE%\.zeroclaw\config.toml

# Add the following block to config.toml
# Replace {address} with your Ozeki SMS Gateway host IP or hostname
# Replace ozk-abc123 with the API key generated for your MCP user account
[mcp]
[[mcp.servers]]
name = "ozeki-sms-mcp"
transport = "http"
url = "http://{address}:9529/mcp"
headers = { "Authorization" = "Bearer ozk-abc123" }

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 ZeroClaw installed on your system, you can download it from here: https://github.com/zeroclaw-labs/zeroclaw

  1. Navigate to the ZeroClaw config directory
  2. Add the Ozeki SMS MCP server entry
  3. Reload the daemon and verify tools

Video tutorial

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

Step 1 - Navigate to the ZeroClaw config directory

Navigate to the ZeroClaw configuration directory at %USERPROFILE%\.zeroclaw\ using File Explorer. You can open this folder quickly by typing %USERPROFILE%\.zeroclaw directly into the File Explorer address bar and pressing Enter (Figure 1).

Navigate to ZeroClaw config directory
Figure 1 - Navigate to the ZeroClaw configuration directory

Open the config.toml file in a text editor such as Notepad or Visual Studio Code. This file stores all ZeroClaw configuration, including any MCP servers (Figure 2).

Open config.toml in text editor
Figure 2 - Open the config.toml file in a text editor

Step 2 - Add the Ozeki SMS MCP server entry

Add the Ozeki SMS MCP server entry to the [mcp] block as shown below. Replace {address} with the IP address or hostname of your Ozeki SMS Gateway installation, and replace ozk-abc123 with the API key you generated for your MCP user account. Save the file after making the changes (Figure 3). 

[mcp]
[[mcp.servers]]
name = "ozeki-sms-mcp"
transport = "http"
url = "http://{address}:9529/mcp"
headers = { "Authorization" = "Bearer ozk-abc123" }

Add Ozeki SMS MCP server to config
Figure 3 - Add the Ozeki SMS MCP server entry to the config

Step 3 - Reload the daemon and verify tools

Open the ZeroClaw dashboard and click Reload daemon to apply the updated configuration. The daemon will restart and connect to all MCP servers listed in the config file (Figure 4).

Reload daemon in ZeroClaw dashboard
Figure 4 - Reload the daemon in the ZeroClaw dashboard

Navigate to the Tools section in the dashboard and verify that the SMS tools exposed by the Ozeki SMS MCP Server are listed. This confirms that ZeroClaw has successfully connected to your gateway (Figure 5).

Navigate to Tools to view SMS MCP tools
Figure 5 - Navigate to Tools to view the SMS MCP tools

Summary

You have successfully added the Ozeki SMS MCP Server to ZeroClaw. The Bearer token in the configuration authenticates every request against your gateway. With the server connected, the agent can send and receive SMS messages through your gateway without any additional setup, simply by being asked to do so in plain language.

More information