whatsappme

WhatsApp-Me

A Claude Code plugin that lets Claude message you on WhatsApp. Get notified on your phone when Claude finishes tasks, runs into errors, or needs your input.

Features

• 📱 Two-way messaging - Claude can send messages AND wait for your replies
• ✅ Task completion alerts - Know when work is done
• ❌ Error notifications - Get alerted when something goes wrong
• 🤔 Questions via WhatsApp - Answer Claude's questions from your phone

How It Works

Claude Code                    WhatsApp-Me MCP Server (local)
    │                                    │
    │  "I finished the task..."          │
    ▼                                    ▼
Plugin ────stdio──────────────────► MCP Server
                                         │
                                         ├─► ngrok tunnel
                                         │
                                         ▼
                                   WhatsApp Cloud API (Meta)
                                         │
                                         ▼
                                   📱 Your Phone buzzes
                                   You reply via WhatsApp
                                   Text returns to Claude

---

Quick Start

Step 1: Create Required Accounts

You need two free accounts:

Account	Sign up
Meta Developer	developers.facebook.com
ngrok	ngrok.com

Step 2: Set Up WhatsApp API

📋 Click to expand WhatsApp setup

2.1 Create Meta App

1. Go to Meta Developer Console
2. Click Create App → Select Other (This is important to see the Business option)
3. Select Business as the app type → Click Next
4. Name your app (e.g., "Message-Me") → Click Create App

2.2 Add WhatsApp Product

1. In your app dashboard, scroll down to WhatsApp → Click Set up
2. You will be redirected to the API Setup page in the sidebar

2.3 Get Your Credentials

From the API Setup page:

• Note your Phone Number ID (under "From" field)
• Important: The token on this page is Temporary (expires in 24 hours). For a permanent setup, follow the steps below.

2.4 Generate Permanent Access Token

To avoid updating your token every 24 hours, create a System User:

1. Go to Meta Business Settings
2. Select Users > System Users → Click Add → Name it "Claude-Bot" → Role: Admin
3. Click Assign Assets → Select Apps → Select your App → Enable Full Control → Save
4. Select the user again → Click Generate New Token
5. Select your App → Check whatsapp_business_messaging and whatsapp_business_management
6. Set Expiration to Never (or the longest available) → Click Generate
7. Copy this token immediately (it will only be shown once)

2.4 Get App Secret

1. Go to Settings → Basic
2. Find App Secret → Click Show → Copy it

2.5 Add Your Phone Number

1. In API Setup, enter your WhatsApp number in the "To" field
2. Format: +15551234567 (country code, no spaces)
3. Click Send Code → Enter the code you receive on WhatsApp

Step 3: Get ngrok Token

📋 Click to expand ngrok setup

1. Sign up at ngrok.com
2. Go to Your Authtoken
3. Copy your authtoken

Step 4: Set Environment Variables

Open ~/.claude/settings.json and add your credentials.

Windows (PowerShell):

notepad "$env:USERPROFILE\.claude\settings.json"

macOS/Linux:

nano ~/.claude/settings.json

Add the following to the env object:

{
  "env": {
    "WHATSAPPME_PHONE_NUMBER_ID": "your_phone_number_id",
    "WHATSAPPME_ACCESS_TOKEN": "your_access_token",
    "WHATSAPPME_APP_SECRET": "your_app_secret",
    "WHATSAPPME_VERIFY_TOKEN": "any_random_string_you_make_up",
    "WHATSAPPME_USER_PHONE_NUMBER": "+15551234567",
    "WHATSAPPME_NGROK_AUTHTOKEN": "your_ngrok_authtoken",
    "WHATSAPPME_PORT": "3333"
  }
}

ℹ️ What each variable does

Variable	Description
WHATSAPPME_PHONE_NUMBER_ID	Your Meta WhatsApp sender ID
WHATSAPPME_ACCESS_TOKEN	API token to send messages (expires in 24h)
WHATSAPPME_APP_SECRET	Used to verify webhook signatures
WHATSAPPME_VERIFY_TOKEN	Your custom string to verify webhook setup
WHATSAPPME_USER_PHONE_NUMBER	Your phone number to receive messages
WHATSAPPME_NGROK_AUTHTOKEN	Authenticates your ngrok tunnel
WHATSAPPME_PORT	The local port the server runs on (default: 3333)

Step 5: Install Plugin