MCP.so
Sign In

WhatsApp Agent MCP Server

@aasherkamal216

Basic information

Category

AI & Agents

Transports

stdio

Author

aasherkamal216

About WhatsApp Agent MCP Server

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

WhatsApp Agent MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Whatsapp_Agent": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

WhatsApp Agent MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

How do I set up the WhatsApp MCP server?

Follow the instructions in the [WhatsApp MCP server README](https://github.com/lharries/whatsapp-mcp).

3

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.

4

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