Titanmind Whatsapp Mcp

Titanmind WhatsApp MCP

A WhatsApp marketing and messaging tool MCP (Model Control Protocol) service using Titanmind. Handles free-form messages (24hr window) and template workflows automatically

Overview

This service provides all the WhatsApp marketing and messaging functionalities using Titanmind. Includes features like template creation and registration with all components header, body, CTAs.., template broadcast to phone numbers in bulk. Read and send messages in an active conversation.

This MCP utilizes Titanmind. Titanmind Account is a requirement to use this MCP.

Titanmind enhances WhatsApp communication by providing powerful features such as conversation management, scheduling, agentic conversations, content generation etc.

Features

Conversation Management

Get Recent Conversations

• Retrieve all conversations with messages sent or received in the last 24 hours
• Returns conversation data with recent activity

Get Conversation Messages

• Fetch all messages from a specific conversation
• Requires: conversation_id (alphanumeric conversation identifier)

Send WhatsApp Message

• Send a message to an existing WhatsApp conversation
• Requires: conversation_id and message content

Template Management

Create Message Template

• Register new WhatsApp message templates for approval
• Configure template name (single word, underscores allowed only)
• Set language (default: "en") and category (MARKETING, UTILITY, AUTHENTICATION)
• Structure message components including:
  • BODY (required): Main text content
  • HEADER (optional): TEXT, VIDEO, IMAGE, or DOCUMENT format
  • FOOTER (optional): Footer text
  • BUTTONS (optional): QUICK_REPLY, URL, or PHONE_NUMBER actions

Get Templates

• Retrieve all created templates with approval status
• Optional filtering by template name

Send Bulk Messages

• Send messages to multiple phone numbers using approved templates
• Requires: template_id and list of contacts
• Contact format: country code alpha (e.g., "IN"), country code (e.g., "91"), and phone number

Installation

Prerequisites

• Python 3.10 or higher
• API Key and Business Code from Titanmind

Usage with MCP Client

In any MCP Client like Claude or Cursor, Titanmind whatsapp MCP config can be added following ways:

Using Titanmind WhatsApp MCP Python package 

1. Install pipx to install the python package globally

# terminal

# Install pipx first
brew install pipx  # on macOS
# or
sudo apt install pipx  # on Ubuntu/Debian

# Then install Titanmind WhatsApp MCP Python package 
pipx install titanmind-whatsapp-mcp

# Make sure '/[HOME_DIR_OR_USER_PRFILE]/.local/bin' is on your PATH environment variable. Use pipx ensurepath to set it.
pipx ensurepath 
 

2. Set the MCP Config python package script in the MCP Client's MCP Configs Json file.

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

Use Remote Titanmind MCP server config

1. Make sure npx is installed in the system
2. Then just add the MCP config

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

Use local python project config

1. First Setup project using instructions mentioned in the Setup Project section.
2. Then add the MCP config

{
  "mcpServers": {
    "TitanMindMCP": {
      "type": "stdio",

... [View full README on GitHub](https://github.com/TitanmindAGI/titanmind-whatsapp-mcp#readme)