TitanMind WhatsApp MCP server for AI agents

This WhatsApp MCP service provides a powerful integration with Titanmind, enabling businesses to manage WhatsApp messaging through both free-form conversations and template-based messaging. It simplifies WhatsApp marketing, template creation, and conversation management through a structured API.

Features

Conversation Management

Get Recent Conversations: Retrieve all conversations with activity in the last 24 hours
Get Conversation Messages: Fetch all messages from a specific conversation
Send WhatsApp Message: Send messages to existing WhatsApp conversations

Template Management

Create Message Templates: Register and configure new templates with customizable components
Get Templates: Retrieve all created templates with their approval status
Send Bulk Messages: Broadcast template messages to multiple recipients

Installation

Prerequisites

Python 3.10 or higher
API Key and Business Code from Titanmind

Installation Options

Option 1: Using Titanmind WhatsApp MCP Python Package

Install pipx to manage the Python package globally:

# On macOS
brew install pipx

# On Ubuntu/Debian
sudo apt install pipx

Install the Titanmind WhatsApp MCP package:

pipx install titanmind-whatsapp-mcp

# Ensure the path is correctly set
pipx ensurepath

Set up the MCP Config in your MCP Client's configuration file:

{
  "mcpServers": {
    "TitanMindMCP": {
      "command": "/[HOME_DIR_OR_USER_PRFILE]/.local/bin/titan-mind-mcp",
      "args": [],
      "env": {
        "api-key": "XXXXXXXXXXXXXXXXXXXXXXXX",
        "bus-code": "XXXXXX"
      }
    }
  }
}

Option 2: Using Remote Titanmind MCP Server

Ensure npx is installed on your system
Add the MCP configuration:

{
  "mcpServers": {
    "TitanMindMCP": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.titanmind.so/whatsapp/mcp/",
        "--header",
        "api-key:XXXXXXXXXXXXXXXXXXXXXXX",
        "--header",
        "bus-code:XXXXXX"
      ]
    }
  }
}

Option 3: Install Package from PyPI

For direct package use:

pip install titanmind-whatsapp-mcp
# Or with uv
uv pip install titanmind-whatsapp-mcp

How It Works

Messaging Modes

The WhatsApp messaging system operates in two distinct modes:

Free-Form Messaging (24-Hour Window)

Available only after a user has sent a message within the last 24 hours
Any content is allowed without pre-approval
Ideal for ongoing conversations and immediate responses

Template Messaging (Outside 24-Hour Window)

Required for new conversations or when the 24-hour window has expired
Only pre-approved, structured message templates can be used
Used for initial outreach and re-engagement campaigns

Messaging Workflow

Check Messaging Window Status:
- Verify if the recipient's phone number is within the free-form messaging window
- Recipients are eligible for free-form messaging if a conversation exists AND they've sent a message in the last 24 hours
Choose Messaging Method:
- Free-Form: Send directly if within 24-hour window
- Template: Use approved templates if outside window
Template Usage (if needed):
- Templates must be approved before use
- Once approved, they become available for bulk messaging
Message Delivery and Verification:
- Send messages using the appropriate method
- Monitor delivery status and recipient engagement

Usage Notes

All functionality integrates with Titanmind's WhatsApp channel
Templates require WhatsApp approval before use in bulk messaging
For additional support, contact Titanmind through their website

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "TitanMindMCP" '{"command":"npx","args":["mcp-remote","https://mcp.titanmind.so/whatsapp/mcp/","--header","api-key:XXXXXXXXXXXXXXXXXXXXXXX","--header","bus-code:XXXXXX"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "TitanMindMCP": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.titanmind.so/whatsapp/mcp/",
                "--header",
                "api-key:XXXXXXXXXXXXXXXXXXXXXXX",
                "--header",
                "bus-code:XXXXXX"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "TitanMindMCP": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.titanmind.so/whatsapp/mcp/",
                "--header",
                "api-key:XXXXXXXXXXXXXXXXXXXXXXX",
                "--header",
                "bus-code:XXXXXX"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect