WhatsApp Agent
@aasherkamal216
About WhatsApp Agent
A WhatsApp agent that uses WhatsApp MCP server to send messages and perform other actions.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"Whatsapp_Agent": {
"command": "uv",
"args": [
"venv"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is WhatsApp Agent?
WhatsApp Agent is an AI-powered agent that interacts with WhatsApp using a WhatsApp MCP server. It can perform multiple actions on the user's behalf, such as searching contacts, reading messages, and sending messages/files.
How to use WhatsApp Agent?
Clone the repository, create a virtual environment with uv, install dependencies, set up environment variables (including an OpenAI API key), and run the Chainlit app with uv run chainlit run chainlit_app.py -w. The app will be available at http://localhost:8000.
Key features of WhatsApp Agent
- Search contacts by name or phone number
- Retrieve messages with optional filters and context
- List available chats with metadata
- Send WhatsApp messages to phone numbers or groups
- Send files (image, video, audio, document) to recipients
Use cases of WhatsApp Agent
- Automatically respond to messages based on user instructions
- Retrieve and summarize recent conversations
- Send scheduled or on-demand messages to contacts
- Download media files from specific chats
- Search for and manage contact information
FAQ from WhatsApp Agent
What are the prerequisites to run WhatsApp Agent?
Python 3.10+, the WhatsApp MCP server, an OpenAI API key (or compatible service like DeepSeek), and uv.
How do I set up the WhatsApp MCP server?
Follow the instructions in the WhatsApp MCP server README.
What can the agent do with WhatsApp messages?
It can list, search, send, and download messages and media using a range of tools provided by the MCP server.
Does the agent work only with OpenAI?
The README states an OpenAI API key is required, but also mentions compatible services like DeepSeek.
Frequently asked questions
What are the prerequisites to run WhatsApp Agent?
Python 3.10+, the WhatsApp MCP server, an OpenAI API key (or compatible service like DeepSeek), and uv.
How do I set up the WhatsApp MCP server?
Follow the instructions in the [WhatsApp MCP server README](https://github.com/lharries/whatsapp-mcp).
What can the agent do with WhatsApp messages?
It can list, search, send, and download messages and media using a range of tools provided by the MCP server.
Does the agent work only with OpenAI?
The README states an OpenAI API key is required, but also mentions compatible services like DeepSeek.
Basic information
More AI & Agents MCP servers
Model Context Protocol for Unreal Engine
chongdashuEnable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).
Just Prompt - A lightweight MCP server for LLM providers
dislerjust-prompt is an MCP server that provides a unified interface to top LLM providers (OpenAI, Anthropic, Google Gemini, Groq, DeepSeek, and Ollama)
Open Multi-Agent Canvas
CopilotKitThe open-source multi-agent chat interface that lets you manage multiple agents in one dynamic conversation and add MCP servers for deep research
MCP Client for Ollama (ollmcp)
joniglHarness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, model switching, streaming responses, human-in-the-loop, thinking mode, model params config, system prompts, and saved pre
Sequential Thinking Multi-Agent System (MAS)
FradSerAn advanced sequential thinking process using a Multi-Agent System (MAS) built with the Agno framework and served via MCP.
Comments