GoWA MCP Server
Officialby dresar
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| APP_OS | No | OS name (device name in WhatsApp) | GOWA |
| DB_URI | No | Database connection URI | file:storages/whatsapp.db |
| APP_HOST | No | Host address to bind the server | 0.0.0.0 |
| APP_PORT | No | Application port | 3000 |
| APP_DEBUG | No | Enable debug logging | false |
| APP_UI_REPO | No | GitHub repository containing gowa-ui releases | dresar/gowa-ui |
| DB_KEYS_URI | No | Optional database URI for encryption/session key cache. Leave blank to use DB_URI; avoid in-memory storage in production because restarts can lose WhatsApp session state. | |
| MCP_ENABLED | No | Serve the streamable HTTP MCP endpoint at /mcp | true |
| CHATWOOT_URL | No | Chatwoot instance URL | |
| APP_BASE_PATH | No | Base path for subpath deployment | |
| APP_BASIC_AUTH | No | Basic authentication credentials | |
| APP_UI_ENABLED | No | Serve the downloaded gowa-ui dashboard | true |
| WHATSAPP_PROXY | No | Outbound proxy for the WhatsApp WebSocket (SOCKS5/HTTP/HTTPS) | |
| CHATWOOT_ENABLED | No | Enable Chatwoot integration | false |
| MCP_OAUTH_DB_URI | No | SQLite URI for OAuth clients, codes, and token hashes | file:storages/oauth.db |
| WHATSAPP_WEBHOOK | No | Webhook URL(s) for events (comma-separated) | |
| APP_UI_ASSET_NAME | No | Dashboard release asset filename | gowa-ui.html |
| CHATWOOT_INBOX_ID | No | Chatwoot inbox ID | |
| CHATWOOT_SIGN_MSG | No | Prefix Chatwoot agent replies with the agent name | false |
| MCP_OAUTH_ENABLED | No | Enable OAuth 2.1 authentication for MCP | false |
| APP_UI_AUTO_UPDATE | No | Download and periodically refresh the latest dashboard | true |
| CHATWOOT_API_TOKEN | No | Chatwoot API access token | |
| CHATWOOT_DEVICE_ID | No | WhatsApp device ID for Chatwoot (single-device/env fallback) | |
| APP_TRUSTED_PROXIES | No | Trusted proxy IP ranges for reverse proxy | |
| APP_UI_ASSET_SHA256 | No | Optional SHA-256 pin for the dashboard asset | |
| APP_UI_GITHUB_TOKEN | No | Optional GitHub token for a higher API rate limit | |
| CHATWOOT_ACCOUNT_ID | No | Chatwoot account ID | |
| CHATWOOT_INBOX_NAME | No | Inbox name used when auto-create is enabled | |
| WHATSAPP_AUTO_REPLY | No | Auto-reply message | |
| CHATWOOT_AUTO_CREATE | No | Auto-create or reuse the Chatwoot API inbox at startup | false |
| CHATWOOT_IGNORE_JIDS | No | JIDs or wildcards to exclude from Chatwoot forwarding | |
| CHATWOOT_WEBHOOK_URL | No | Public GOWA Chatwoot reply webhook URL | |
| MCP_OAUTH_ISSUER_URL | No | Public HTTPS OAuth issuer URL | |
| CHATWOOT_MESSAGE_READ | No | Sync read state for linked WhatsApp/Chatwoot messages | false |
| APP_UI_UPDATE_INTERVAL | No | Interval between dashboard update checks | 3h |
| CHATWOOT_ALLOWED_HOSTS | No | Allowlist of Chatwoot hosts for per-device configs (SSRF guard) | |
| CHATWOOT_FORWARD_EDITS | No | Mirror WhatsApp edits into Chatwoot threaded notes | true |
| CHATWOOT_IMPORT_DB_URI | No | Direct Chatwoot PostgreSQL URI for history sync | |
| MCP_OAUTH_RESOURCE_URL | No | Optional canonical public MCP URL | |
| CHATWOOT_MESSAGE_DELETE | No | Delete linked opposite-side messages when deletion is reported | false |
| CHATWOOT_SIGN_DELIMITER | No | Delimiter between Chatwoot agent signature and message body | \n\n |
| CHATWOOT_WEBHOOK_SECRET | No | Shared secret required for incoming Chatwoot webhooks | |
| WHATSAPP_AUTO_MARK_READ | No | Auto-mark incoming messages as read | false |
| WHATSAPP_WEBHOOK_EVENTS | No | Whitelist of events to forward (comma-separated, empty = all) | |
| WHATSAPP_WEBHOOK_SECRET | No | Webhook secret for validation | secret |
| APP_CORS_ALLOWED_ORIGINS | No | Allowed CORS origins (any origin when empty) | |
| CHATWOOT_FORWARD_DELETES | No | Mirror WhatsApp delete-for-everyone events into Chatwoot notes | true |
| CHATWOOT_IMPORT_MESSAGES | No | Enable message history sync to Chatwoot | false |
| WHATSAPP_AUTO_REJECT_CALL | No | Auto-reject incoming WhatsApp calls | false |
| CHAT_STORAGE_MAX_OPEN_CONNS | No | Maximum concurrent SQLite connections for chat storage | 5 |
| WHATSAPP_ACCOUNT_VALIDATION | No | Enable account validation | true |
| CHATWOOT_REOPEN_CONVERSATION | No | Reopen resolved Chatwoot conversations for returning contacts | true |
| WHATSAPP_AUTO_DOWNLOAD_MEDIA | No | Auto-download media from incoming messages | true |
| WHATSAPP_IGNORE_STATUS_MEDIA | No | Ignore downloading status media (status@broadcast) | false |
| WHATSAPP_PRESENCE_ON_CONNECT | No | Presence on connect: available, unavailable, or none | unavailable |
| WHATSAPP_WEBHOOK_IGNORE_JIDS | No | JIDs/wildcards to skip when forwarding (comma-separated) | |
| CHATWOOT_CONVERSATION_PENDING | No | Create new Chatwoot conversations as pending | false |
| CHATWOOT_IMPORT_MEDIA_WITH_REST | No | Upload direct-DB import media rows through Chatwoot REST | false |
| WHATSAPP_PRESENCE_PULSE_ENABLED | No | Enable daily available/unavailable presence pulse | true |
| WHATSAPP_PRESENCE_PULSE_DURATION | No | Duration to stay available during each pulse | 5m |
| WHATSAPP_PRESENCE_PULSE_INTERVAL | No | Interval between presence pulses | 24h |
| CHATWOOT_DAYS_LIMIT_IMPORT_MESSAGES | No | Days of history to import | 3 |
| WHATSAPP_WEBHOOK_DEVICE_MERGE_GLOBAL | No | Per-device webhook adds to the global URLs instead of replacing them | false |
| WHATSAPP_WEBHOOK_INSECURE_SKIP_VERIFY | No | Skip TLS verification for webhooks (insecure) | false |
| CHATWOOT_IMPORT_PLACEHOLDER_MEDIA_MESSAGE | No | Insert text placeholders for media rows during direct DB import | true |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
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 | |
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessNo issues