timestamp

MCP tool from Whatsapp MCP by verygoodplugins

(optional): RFC 3339 read timestamp; defaults to the current time

How to use it

timestamp is exposed by the Whatsapp MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the timestamp tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install Whatsapp MCP

$uv pip install -e ".[dev]"

FULL WHATSAPP MCP LISTING

Other tools in Whatsapp MCP (39)

after

(optional): Number of messages after (default 5)

after_date

(optional): Messages after this date (YYYY-MM-DD)

before

(optional): Number of messages before (default 5)

before_date

(optional): Messages before this date (YYYY-MM-DD)

caption

(optional): Caption for the media

chat_jid

(optional): Filter by specific chat JID

download_media

Download media from a received message.

emoji

(required): Reaction emoji (e.g. "👍"). Pass an empty string "" to remove an existing reaction.

file_path

(required): Path to the file

from_me

(optional, default false): Whether the original message was sent by the current user

get_chat

Get specific chat metadata by JID.

get_contact

Resolve a WhatsApp contact name from a phone number, LID, or full JID.

get_contact_chats

List all chats involving a specific contact.

get_direct_chat_by_contact

Find a direct message chat with a contact.

get_last_interaction

Get the last message exchanged with a contact.

get_message_context

Get messages around a specific message for context.

identifier

(required): Phone number, LID, or full JID (aliases: phonenumber, phone)

jid

(required): Chat JID

limit

(optional): Number of messages (default 50, max 500)

list_chats

List all chats with metadata.

list_messages

Get messages with filters, date ranges, and sorting.

mark_messages_read

Mark one or more messages from the same chat and sender as read. This explicitly

mentions

(optional): List of users to @-mention, as phone numbers with country code (e.g. ["12025551234"]) or JIDs. For each entry the message text must contain a matching @<number> token (e.g. "thanks @12025551234!"), which recipients' devices render as a highlighted, tappable mention that also notifies the

message

(required): Text content to send

message_id

(required): ID of the message to react to

message_ids

(required): IDs of messages from the same chat and sender

phone

(required): Phone number of the contact

query

(required): Name or phone number to search

quoted_content

(optional): Text content of the quoted message, used for the reply preview. Only plain text is supported.

quoted_message_id

(optional): ID of the message to reply to. When provided, the sent message appears as a quoted reply in WhatsApp.

quoted_sender_jid

(optional): Full JID of the author of the quoted message. Required for group replies so WhatsApp renders the correct attribution header.

recipient

(required): Phone number or group JID

search_contacts

Search contacts by name or phone number.

send_audio_message

Send a voice message (automatically converts to Opus .ogg format).

send_file

Send a media file (image, video, document).

send_message

Send a text message to a contact or group, optionally as a quoted reply.

send_reaction

Send (or remove) an emoji reaction to a message.

sender_jid

(required for groups): Full JID or bare phone number of the original message sender

sort_by

(optional): "newest" or "oldest" (default "newest")