{"id":"felipeadeildo-whatsapp-mcp","name":"whatsapp-mcp","homepage":null,"repo_url":"https://github.com/felipeadeildo/whatsapp-mcp","category":"communication","subcategories":[],"tags":["mcp","whatsapp","whatsapp-web","automation","ai-agents","go","sqlite","search"],"what_it_does":"An MCP server that connects to WhatsApp Web (via whatsmeow), syncs messages to a local SQLite database, and exposes WhatsApp functionality (tools/prompts/resources) to MCP-compatible AI clients over an HTTP/SSE endpoint. It supports chat listing, message retrieval with pagination/sender filtering, cross-chat search, finding chats by fuzzy name, sending messages, loading older history, and retrieving the user profile info.","use_cases":["Let an AI summarize or analyze WhatsApp conversations","Search for mentions or keywords across all chats","Find and reply to someone’s latest messages with context","Workflow-style chat automation via MCP prompts/resources","Assist with triage by pulling relevant past messages from a local store"],"not_for":["Production-grade, high-assurance WhatsApp automation without due diligence","Environments requiring strict compliance guarantees or official WhatsApp API support","Use by untrusted users/agents without network isolation and strong operational controls"],"best_when":"You have a trusted environment, can secure local session/database data, and want an AI agent to interact with WhatsApp through MCP tools.","avoid_when":"You cannot secure access to the MCP HTTP endpoint (API key in URL path), your threat model includes attackers who could exfiltrate WhatsApp data, or you require clearly documented rate limits/error semantics for automated agent retries.","alternatives":["Official WhatsApp Business Platform APIs (via Meta) for supported integrations","Browser automation / unofficial libraries (lower assurance; similar risks)","Other MCP/agent adapters that integrate with messaging systems via supported backends","Build a custom integration around an existing WhatsApp gateway or bot platform"],"af_score":56.2,"security_score":46.5,"reliability_score":26.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:19:37.504179+00:00","interface":{"has_rest_api":true,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":"http://localhost:8080/mcp/{API_KEY}","has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["API key in MCP endpoint URL path (e.g., /mcp/{API_KEY})"],"oauth":false,"scopes":false,"notes":"Authentication is described as an API key placed directly in the URL path. The README does not describe fine-grained scopes, rotation, or how the server handles leaked keys (e.g., logging/redaction)."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Open-source project; no pricing information provided."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":56.2,"security_score":46.5,"reliability_score":26.2,"mcp_server_quality":75.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":85.0,"rate_limit_clarity":20.0,"tls_enforcement":70.0,"auth_strength":45.0,"scope_granularity":20.0,"dependency_hygiene":55.0,"secret_handling":45.0,"security_notes":"Security is described as “API key authentication” and “HTTPS ready,” but details are not provided. The API key is embedded in the URL path, which increases leakage risk via logs, browser history, or intermediary proxies. Data is stored locally and includes sensitive WhatsApp content and session credentials; README warns about file permissions. Unofficial WhatsApp Web integration introduces operational and security risk beyond the typical official API threat model.","uptime_documented":0.0,"version_stability":40.0,"breaking_changes_history":30.0,"error_recovery":35.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"timestamp-based pagination for get_chat_messages; load_more_messages for older history","retry_guidance_documented":false,"known_agent_gotchas":["API key is in the URL path; agents/clients or proxies may log URLs (potential key leakage).","No documented rate-limit behavior; agents may need conservative retries/backoff to avoid overload.","WhatsApp unofficial API may be brittle (session/connection changes), which can impact tool reliability."]}}