Relay for WhatsApp
viaanshetty3-debug/relay-whatsapp-mcp
Your WhatsApp as 37 MCP tools: read, search, send and media, via a self-hosted bridge.
- tools
- 37
- transport
- STDIO
- env vars
- 2
- last updated
- Nov 13, 2026
Tools
37 toolsPublic tool metadata for what this MCP can expose to an agent.
statusConnection state, live event cursor, counts and capabilities
Connection state, live event cursor, counts and capabilities
No parameter schema in public metadata yet.
list_chatsChats with names, unread counts, previews and exact chat IDs (JIDs)
Chats with names, unread counts, previews and exact chat IDs (JIDs)
No parameter schema in public metadata yet.
list_contactsSearch contact names and WhatsApp IDs
Search contact names and WhatsApp IDs
No parameter schema in public metadata yet.
get_messagesRead messages newest first, with pagination; never sends read receipts
Read messages newest first, with pagination; never sends read receipts
No parameter schema in public metadata yet.
search_messagesLiteral text search across one chat or every permitted chat
Literal text search across one chat or every permitted chat
No parameter schema in public metadata yet.
wait_updatesLive messages, edits, receipts, reactions and presence after a durable cursor
Live messages, edits, receipts, reactions and presence after a durable cursor
No parameter schema in public metadata yet.
export_chatExport a page of history as JSON or plain text
Export a page of history as JSON or plain text
No parameter schema in public metadata yet.
send_messageSend a text or reply; `requestId` de-duplicates retries
Send a text or reply; `requestId` de-duplicates retries
No parameter schema in public metadata yet.
edit_messageEdit your own text message (WhatsApp time limits apply)
Edit your own text message (WhatsApp time limits apply)
No parameter schema in public metadata yet.
delete_messageDelete your own message for everyone
Delete your own message for everyone
No parameter schema in public metadata yet.
react_messageAdd or remove an emoji reaction
Add or remove an emoji reaction
No parameter schema in public metadata yet.
forward_messageForward a message to another permitted chat
Forward a message to another permitted chat
No parameter schema in public metadata yet.
create_pollCreate a poll
Create a poll
No parameter schema in public metadata yet.
mark_readSend read receipts for specific messages, only when you ask
Send read receipts for specific messages, only when you ask
No parameter schema in public metadata yet.
list_mediaFind photos, videos, voice notes, stickers and documents in history
Find photos, videos, voice notes, stickers and documents in history
No parameter schema in public metadata yet.
download_mediaDownload an attachment up to 500 MB (inline if small, otherwise a file handle)
Download an attachment up to 500 MB (inline if small, otherwise a file handle)
No parameter schema in public metadata yet.
read_mediaInspect an attachment as a native image, audio or document, or as a file handle
Inspect an attachment as a native image, audio or document, or as a file handle
No parameter schema in public metadata yet.
read_media_chunkRead a cached attachment in bounded chunks
Read a cached attachment in bounded chunks
No parameter schema in public metadata yet.
media_capabilitiesCheck local transcription, PDF, video-frame and vision support
Check local transcription, PDF, video-frame and vision support
No parameter schema in public metadata yet.
analyze_mediaStart a local analysis job: transcription, text extraction or visual description
Start a local analysis job: transcription, text extraction or visual description
No parameter schema in public metadata yet.
get_media_analysisJob status and paginated results
Job status and paginated results
No parameter schema in public metadata yet.
cancel_media_analysisCancel a queued or running analysis job
Cancel a queued or running analysis job
No parameter schema in public metadata yet.
delete_cached_mediaRemove a cached download or upload (doesn't touch WhatsApp)
Remove a cached download or upload (doesn't touch WhatsApp)
No parameter schema in public metadata yet.
create_media_uploadStart a chunked upload for sending a file up to 500 MB
Start a chunked upload for sending a file up to 500 MB
No parameter schema in public metadata yet.
upload_media_chunkAppend up to 1 MB to an upload (safe to retry at the same offset)
Append up to 1 MB to an upload (safe to retry at the same offset)
No parameter schema in public metadata yet.
send_mediaSend an image, video, audio or document
Send an image, video, audio or document
No parameter schema in public metadata yet.
get_groupGroup subject, description, participants and roles
Group subject, description, participants and roles
No parameter schema in public metadata yet.
update_groupChange a group's subject or description
Change a group's subject or description
No parameter schema in public metadata yet.
set_presenceOnline/offline, typing or recording indicators
Online/offline, typing or recording indicators
No parameter schema in public metadata yet.
subscribe_presenceReceive a chat's typing and presence events through `wait_updates`
Receive a chat's typing and presence events through `wait_updates`
No parameter schema in public metadata yet.
set_chat_settingsArchive/unarchive, mute/unmute
Archive/unarchive, mute/unmute
No parameter schema in public metadata yet.
save_draftSave or update a local draft without sending
Save or update a local draft without sending
No parameter schema in public metadata yet.
list_draftsList drafts
List drafts
No parameter schema in public metadata yet.
delete_draftDelete a draft
Delete a draft
No parameter schema in public metadata yet.
schedule_messageSchedule a text for an ISO 8601 time; interrupted sends become *uncertain*, never re-sent
Schedule a text for an ISO 8601 time; interrupted sends become *uncertain*, never re-sent
No parameter schema in public metadata yet.
list_scheduledScheduled messages and their delivery status
Scheduled messages and their delivery status
No parameter schema in public metadata yet.
cancel_scheduledCancel a pending scheduled message
Cancel a pending scheduled message
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
RELAY_HOMEFolder with Relay's .env and WhatsApp session (default: ~/.relay-whatsapp-mcp). Run `npx relay-whatsapp-mcp setup` and `start` first.
BRIDGE_URLAddress of the running Relay bridge (default: http://127.0.0.1:8787)
Readme
Relay
Your WhatsApp, as 38 MCP tools for Claude and ChatGPT: self-hosted, failover-ready, and free to run.
Details
- Repository
- github.com/viaanshetty3-debug/relay-whatsapp-mcp
- Website
- github.com/viaanshetty3-debug/relay-whatsapp-mcp#readme
- Categories
- Communication & Messaging, Search & Web Crawling, Media & Entertainment
- Package
relay-whatsapp-mcp- Transport
- STDIO
- Registry
- MCP registry, active
