WhatsApp Approval
MCP server with Whatsapp integration (Twilio) to remote approve Claude Code tool use
What is WhatsApp Approval?
WhatsApp Approval is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server with whatsapp integration (twilio) to remote approve claude code tool use
MCP server with Whatsapp integration (Twilio) to remote approve Claude Code tool use
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server with Whatsapp integration (Twilio) to remote appr
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx claude-code-whatsapp-approvalConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use WhatsApp Approval
The Claude Code WhatsApp Approval MCP Server adds a remote human-in-the-loop approval gate to Claude Code by routing tool-use permission requests through WhatsApp via Twilio. When Claude Code is about to execute a sensitive tool, the server sends an interactive WhatsApp message with Approve and Deny quick-reply buttons, and waits up to 5 minutes for a response before timing out. This lets developers safely run Claude Code in automated or unattended contexts while maintaining human oversight over consequential actions.
Prerequisites
- Python 3.10+ and the uv package manager installed
- A Twilio account with WhatsApp sandbox access and a verified WhatsApp number
- Twilio Account SID, Auth Token, and a WhatsApp-capable sender number
- A public HTTPS URL (via ngrok, Tailscale, or a cloud server) for the Twilio webhook
- Claude Code CLI installed and configured
Clone the repository and install dependencies
Clone the project and install Python dependencies using uv.
git clone https://github.com/adstastic/claude-code-whatsapp-approval.git
cd claude-code-whatsapp-approval
uv installConfigure environment variables
Create a .env file with your Twilio credentials and the phone number that will receive approval requests.
TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_AUTH_TOKEN=your_auth_token
TWILIO_WHATSAPP_FROM=whatsapp:+14155238886
APPROVAL_PHONE=whatsapp:+1your_number
SERVER_PORT=8000Set up the WhatsApp message template
Run the setup script to create the WhatsApp approval message template in your Twilio account.
python setup_template.pyExpose the server publicly via ngrok
Start ngrok to create a public HTTPS URL that Twilio can reach for webhook callbacks.
ngrok http 8000Configure the Twilio webhook
In the Twilio Console, set the WhatsApp sandbox webhook URL to your ngrok URL followed by /twilio-webhook.
# Set in Twilio Console → Messaging → Try it out → Send a WhatsApp message
# Webhook URL: https://your-ngrok-id.ngrok.io/twilio-webhookStart the approval server and run Claude Code
Start the approval server, then run Claude Code with the permission-prompt-tool flag pointing to this server.
uv run approval_server.py
# In another terminal:
claude --mcp-config mcp-servers.json \
--permission-prompt-tool mcp__approval-server__permissions__approve \
-p "your prompt here"WhatsApp Approval Examples
Client configuration
MCP server configuration file (mcp-servers.json) for the WhatsApp approval server.
{
"mcpServers": {
"approval-server": {
"command": "uv",
"args": ["run", "approval_server.py"],
"env": {
"TWILIO_ACCOUNT_SID": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"TWILIO_AUTH_TOKEN": "your_auth_token",
"TWILIO_WHATSAPP_FROM": "whatsapp:+14155238886",
"APPROVAL_PHONE": "whatsapp:+1your_number",
"SERVER_PORT": "8000"
}
}
}
}Prompts to try
Example Claude Code tasks that will trigger approval requests via WhatsApp.
- "Delete all log files older than 30 days from the /var/log directory"
- "Push the current branch to the remote repository"
- "Run the database migration script on the staging environment"
- "Send the weekly summary email to the distribution list"Troubleshooting WhatsApp Approval
Twilio webhook times out and approvals never arrive
Ensure the approval server is running and that your ngrok tunnel is active. Verify the webhook URL in Twilio matches the exact path: https://your-ngrok-id.ngrok.io/twilio-webhook.
WhatsApp messages are received but reply buttons do not work
Confirm you ran python setup_template.py successfully to register the interactive template. The Twilio WhatsApp sandbox requires template approval for interactive messages.
Approval requests expire after 5 minutes
This is by design for security. If you need more time, you can modify the expiry timeout in approval_server.py. Make sure your phone has WhatsApp notifications enabled so you see requests promptly.
Frequently Asked Questions about WhatsApp Approval
What is WhatsApp Approval?
WhatsApp Approval is a Model Context Protocol (MCP) server that mcp server with whatsapp integration (twilio) to remote approve claude code tool use It connects AI assistants to external tools and data sources through a standardized interface.
How do I install WhatsApp Approval?
Follow the installation instructions on the WhatsApp Approval GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with WhatsApp Approval?
WhatsApp Approval works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is WhatsApp Approval free to use?
Yes, WhatsApp Approval is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
WhatsApp Approval Alternatives — Similar Communication Servers
Looking for alternatives to WhatsApp Approval? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up WhatsApp Approval in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use WhatsApp Approval?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.