mcpField
W
WhatsApp Agent

WhatsApp Agent

Local
github.com/aasherkamal216AI & Agents4Updated 80w ago
Repository

About WhatsApp Agent

WhatsApp Agent is an agent that acts through the WhatsApp MCP server, for users managing WhatsApp chats and messages through conversation. It can search contacts, inspect chats and messages, and send messages and files.

Key features

  1. 01Search contacts
  2. 02View chats and messages
  3. 03Retrieve contact interaction history
  4. 04Send messages and files
  5. 05Download message media

Use cases

  1. 01Review recent chats and messages
  2. 02Message a contact or group
  3. 03Download media from a chat

MCP support

The agent connects to the WhatsApp MCP server and uses its tools to search contacts, read chats and messages, and send messages, files, and audio.

#agent#mcp#openai#whatsapp#uv#llm#chainlit#deepseek

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

WhatsApp Agent

An Agent that interacts with WhatsApp using WhatsApp MCP server. It can perform multiple actions on the user's behalf.

WhatsApp Agent

🚀 Features

The Agent is connected to WhatsApp MCP server. This server provides the following tools:

  • search_contacts: Search for contacts by name or phone number
  • list_messages: Retrieve messages with optional filters and context
  • list_chats: List available chats with metadata
  • get_chat: Get information about a specific chat
  • get_direct_chat_by_contact: Find a direct chat with a specific contact
  • get_contact_chats: List all chats involving a specific contact
  • get_last_interaction: Get the most recent message with a contact
  • get_message_context: Retrieve context around a specific message
  • send_message: Send a WhatsApp message to a specified phone number or group JID
  • send_file: Send a file (image, video, raw audio, document) to a specified recipient
  • send_audio_message: Send an audio file as a WhatsApp voice message (requires the file to be an .ogg opus file or ffmpeg must be installed)
  • download_media: Download media from a WhatsApp message and get the local file path

⚡Quick Start

Prerequisites

  • Python 3.10+
  • WhatsApp MCP server
  • An OpenAI API key (or compatible service like DeepSeek)
  • uv

Note

To setup WhatsApp MCP server, follow the instructions in the README.

Installation

Follow these steps to set up the project on your local machine:

  1. Clone the repository

    git clone https://github.com/aasherkamal216/whatsapp_agent.git
cd whatsapp_agent

  2. Create and activate a virtual environment

    uv venv
# On macOS/Linux
source .venv/bin/activate
# On Windows
.venv\Scripts\activate

  3. Install dependencies

    uv sync

  4. Set up environment variables

    Copy the example environment file and update it with your credentials:

    cp .env.example .env

    Add your environment variables to the .env file.

Usage

Run the Chainlit app:

uv run chainlit run chainlit_app.py -w

The application will be running at http://localhost:8000

Example Questions

Here are some example questions you can ask the WhatsApp Agent:

  • Show me my recent chats.
  • Send a message to John Doe: "Meeting at 5pm."
  • List all messages from John in the last week.
  • Download the last photo sent in the SF News group.
  • Search for contacts named Alex.
  • Get the last interaction with +1234567890.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.