whatsapp_sync
WhatsApp · macOS · Windows
Effect: write (strongest supported action). Status: gated.
Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.
macOS
Purpose
Starts WhatsApp pulling the latest messages, groups and contacts into the local store and returns right away — it does NOT wait for the sync to finish (#1453: a first sync after linking can legitimately take minutes, and waiting for it used to get the sync itself killed by the local timeout). Call whatsapp_diagnose to see whether a sync is still running or when the last one finished. The other read tools also kick off a sync in the BACKGROUND, so the FIRST read after new activity may be stale — re-run it in a few seconds.
Required inputs
No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.
Permissions and confirmation
No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
Full input schema — macOS
{
"properties": {
"account": {
"description": "Which linked WhatsApp account to use: its label or id from whatsapp_list_accounts. Leave it out to use the default account.",
"type": "string"
}
},
"type": "object"
}Documentation example
Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.
{}Windows
Purpose
Starts WhatsApp pulling the latest messages, groups and contacts into the local store and returns right away — it does NOT wait for the sync to finish (#1453: a first sync after linking can legitimately take minutes, and waiting for it used to get the sync itself killed by the local timeout). Call whatsapp_diagnose to see whether a sync is still running or when the last one finished. The other read tools also kick off a sync in the BACKGROUND, so the FIRST read after new activity may be stale — re-run it in a few seconds.
Required inputs
No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.
Permissions and confirmation
Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
Full input schema — Windows
{
"properties": {
"account": {
"description": "Which linked WhatsApp account to use: its label or id from whatsapp_list_accounts. Leave it out to use the default account.",
"type": "string"
},
"confirm": {
"description": "Ignored; kept for older clients.",
"type": "boolean"
}
},
"type": "object"
}Documentation example
Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.
{
"confirm": false
}