WhatsApp MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TZ | No | Container timezone — affects log timestamps and time-based features (e.g. catch_up 'today' window). Use IANA names: America/Toronto, Europe/Paris, Asia/Tokyo. | UTC |
| DEBUG | No | When set to 'true', emits verbose diagnostic output to stderr | |
| STORE_PATH | No | Session + message database directory | /data/sessions |
| AUDIT_DB_PATH | No | Audit log database path | /data/audit/audit.db |
| PRESENCE_MODE | No | Online presence: available or unavailable | available |
| DISABLED_TOOLS | No | Comma-separated tool names to disable | |
| ALLOWED_CONTACTS | No | Comma-separated phone whitelist (empty = allow all) | |
| AUTH_WAIT_FOR_LINK | No | Default: after authenticate shows code/QR, wait and poll until linked (false = return immediately) | false |
| AUTO_READ_RECEIPTS | No | Auto-read incoming messages (senders see blue checkmarks immediately) | true |
| RATE_LIMIT_PER_MIN | No | Max outbound messages per minute | 60 |
| SEND_READ_RECEIPTS | No | Send read receipts to WhatsApp when mark_messages_read is called | true |
| WELCOME_GROUP_NAME | No | WhatsApp group created on first connection (empty = disable) | WhatsAppMCP |
| DATA_ENCRYPTION_KEY | No | Passphrase for AES-256-GCM field encryption. Store via docker mcp secret set or set in .env. | |
| AUTH_LINK_TIMEOUT_SEC | No | Default max seconds to wait for link when waiting (15–600) | 120 |
| AUTH_POLL_INTERVAL_SEC | No | Default seconds between connection checks when waiting (2–60) | 5 |
| MESSAGE_RETENTION_DAYS | No | Auto-delete messages/media older than N days (0 = keep forever) | 90 |
| AUTO_CONNECT_ON_STARTUP | No | When true, automatically reconnects to WhatsApp at container startup if valid session exists | true |
| DOWNLOAD_RATE_LIMIT_PER_MIN | No | Max media downloads per minute | 30 |
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Malaccamaxgit/whatsapp-mcp-docker'
If you have feedback or need assistance with the MCP directory API, please join our Discord server