MCP.so
Sign In

WhatsApp Agent

@aasherkamal216

About WhatsApp Agent

A WhatsApp agent that uses WhatsApp MCP server to send messages and perform other actions.

Basic information

Category

AI & Agents

Runtime

python

Transports

stdio

Publisher

aasherkamal216

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.

Comments

More AI & Agents MCP servers