WhatsApp → ChatGPT (via MCP)

Connects WhatsApp to ChatGPT: each client/agency becomes a Project in ChatGPT, with a daily report (via Scheduled) and free-form questions about the conversations. Zero cost — everything open-source/self-hosted.

WhatsApp ←QR code→ Evolution API ←→ servidor MCP ←→ ChatGPT (Modo de desenvolvedor)
                               ↓
                        Postgres (sessão + mensagens)

Structure

Related MCP server: WhatsApp Cloud API MCP Server

Deployment guide

1. Infrastructure (~15 min, on an Ubuntu VPS with Docker)

git clone https://github.com/rafaelacoelhob/whatsapp-chatgpt-mcp.git
cd whatsapp-chatgpt-mcp
cp .env.example .env
nano .env   # preencher senhas e domínio (instruções no próprio arquivo)
docker compose up -d

Requirement: a domain/subdomain pointing to the VPS IP (A record) — Caddy issues the HTTPS certificate on its own.

2. Connect WhatsApp (2 min, once)

1. Access the Evolution panel: http://<servidor>:8080/manager (login = EVOLUTION_API_KEY)

2. Create an instance with the name defined in EVOLUTION_INSTANCE (integration: Baileys)

3. On the phone: WhatsApp → Settings → Connected devices → Connect device → scan the QR

Test first with YOUR number; then repeat with the final number (changing EVOLUTION_INSTANCE or creating another instance).

3. Plug into ChatGPT (3 min)

1. ChatGPT → Settings → Plugins → Developer mode → create connector

2. URL: https://<dominio-do-mcp>/mcp/<MCP_PATH_SECRET>

3. Test in a chat: "List my recent WhatsApp conversations" and "Summarize the messages I received today"

4. Projects per agency (2 min each)

Create a Project in ChatGPT for each agency with these instructions (adapt as needed):

Você acompanha as conversas da AGÊNCIA X no meu WhatsApp (use as
ferramentas do conector WhatsApp).

Contatos conhecidos da agência:
- Fulana — +55 11 9XXXX-XXXX
- Grupo "Agência X"

Contatos novos: se uma conversa de número desconhecido claramente for
desta agência, inclua no relatório na seção "🆕 Contato novo — confirmar".
Só trate como contato fixo depois que eu confirmar.

Relatório do dia — quando eu pedir, busque as mensagens de hoje e
organize em: 📌 Decisões / ⏳ Pendências / 📅 Prazos / ❗ Precisa de
resposta / 🆕 Contatos novos.

Responda sempre em português, direto. Se a informação não estiver nas
conversas, diga que não está — não invente.

5. Automatic daily report

ChatGPT → Scheduled → new task: "Every day at 6 PM, search WhatsApp for today's messages from [agency/contacts] and generate the day's report in the format Decisions / Pending / Deadlines / Needs a response / New contacts." (Business: up to 15 active tasks; beyond that, use a single task that covers all agencies.)

Blocked numbers list

BLOCKED_NUMBERS in .env (with country code, separated by commas). It is a technical filter on the server: conversations from these numbers are never delivered to ChatGPT, regardless of what is asked. Changed the .env → docker compose up -d again to apply.

Maintenance (what can happen)

• WhatsApp session dropped (rare): rescan the QR in the Evolution panel (step 2).

• Server restarted: containers come back on their own (restart: always); the session survives (it stays in Postgres).

• Disconnect for good: on the phone, Connected devices → end session; docker compose down; remove the connector in ChatGPT.

Warnings

• Evolution uses the WhatsApp Web-style bridge — not official from Meta. Ban risk is low for reading, but not zero; the owner of the number must be aware.

• Conversations pass through the server and OpenAI (ChatGPT standard).