Skip to main content

​
Add WhatsApp Tool to AI Agent

​
Quick Start

1

Set Up WhatsApp MCP Server

Clone and set up the WhatsApp MCP server:
git clone https://github.com/lharries/whatsapp-mcp.git
cd whatsapp-mcp
cd whatsapp-bridge
go run main.go
2

Create a file

Create a new file whatsapp_message.py with the following code:
from praisonaiagents import Agent, MCP

whatsapp_agent = Agent(
    instructions="Whatsapp Agent",
    llm="gpt-4o-mini",
    tools=MCP("python /path/to/whatsapp-mcp/whatsapp-mcp-server/main.py")
)

whatsapp_agent.start("Send Hello to Mervin Praison")
Note: Replace /path/to/whatsapp-mcp with the actual path to your WhatsApp MCP server.
3

Install Dependencies

Make sure you have the required packages installed:
pip install "praisonaiagents[llm]" mcp gradio
4

Export API Key

export OPENAI_API_KEY="your_api_key"
5

Run the Agent

Execute your script:
python whatsapp_message.py
Requirements
  • Python 3.10 or higher
  • WhatsApp MCP server set up and configured

​
Multi-Agent Integration

You can also combine WhatsApp with other MCP tools, such as Airbnb search: 
from praisonaiagents import Agent, AgentTeam, MCP

airbnb_agent = Agent(
    instructions="""Search for Apartments in Paris for 2 nights on Airbnb. 04/28 - 04/30 for 2 adults""",
    llm="gpt-4o-mini",
    tools=MCP("npx -y @openbnb/mcp-server-airbnb --ignore-robots-txt")
)

whatsapp_agent = Agent(
    instructions="""Send AirBnb Search Result to 'Mervin Praison'""",
    llm="gpt-4o-mini",
    tools=MCP("python /path/to/whatsapp-mcp/whatsapp-mcp-server/main.py")
)

agents = AgentTeam(agents=[airbnb_agent, whatsapp_agent])

agents.start()

​
Alternative LLM Integrations

​
Using Groq with WhatsApp

from praisonaiagents import Agent, MCP

whatsapp_agent = Agent(
    instructions="Whatsapp Agent",
    llm="groq/llama-3.2-90b-vision-preview",
    tools=MCP("python /path/to/whatsapp-mcp/whatsapp-mcp-server/main.py")
)

whatsapp_agent.start("Send Hello to Mervin Praison")

​
Using Ollama with WhatsApp

from praisonaiagents import Agent, MCP

whatsapp_agent = Agent(
    instructions="Whatsapp Agent",
    llm="ollama/llama3.2",
    tools=MCP("python /path/to/whatsapp-mcp/whatsapp-mcp-server/main.py")
)

whatsapp_agent.start("Send Hello to Mervin Praison. Use send_message tool, recipient and message are the required parameters.")

​
Gradio UI Integration

Create a Gradio UI for your WhatsApp and Airbnb integration: 
from praisonaiagents import Agent, AgentTeam, MCP
import gradio as gr

def search_airbnb(query):
    airbnb_agent = Agent(
        instructions=query+" on Airbnb",
        llm="gpt-4o-mini",
        tools=MCP("npx -y @openbnb/mcp-server-airbnb --ignore-robots-txt")
    )

    whatsapp_agent = Agent(
        instructions="""Send AirBnb Search Result to 'Mervin Praison'. Don't include Phone Number in Response, but include the AirBnb Search Result""",
        llm="gpt-4o-mini",
        tools=MCP("python /path/to/whatsapp-mcp/whatsapp-mcp-server/main.py")
    )

    agents = AgentTeam(agents=[airbnb_agent, whatsapp_agent])

    result = agents.start()
    return f"## Airbnb Search Results\n\n{result}"

demo = gr.Interface(
    fn=search_airbnb,
    inputs=gr.Textbox(placeholder="I want to book an apartment in Paris for 2 nights..."),
    outputs=gr.Markdown(),
    title="WhatsApp MCP Agent",
    description="Enter your booking requirements below:"
)

if __name__ == "__main__":
    demo.launch()

​
Features

WhatsApp Messaging

Send messages to WhatsApp contacts directly from your AI agent.

Multi-Agent Support

Combine WhatsApp with other MCP tools for complex workflows.

Multiple LLM Options

Use with OpenAI, Groq, Ollama, or other supported LLMs.

Gradio UI

Create user-friendly interfaces for your WhatsApp integrations.