Add annotation
Add a note to a date on the main traffic chart.
MCP tool plausible_write → add_annotation
write Confirm
Does what right-click > Add note does on the chart. A site note is seen by all team members and by anyone using a shared link, and only team members with editor access or above can add one. Plausible allows 500 annotations per site. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| site string required | string | Domain of the site as the Sites page lists it, e.g. acme-shop.example. |
| date string required | string | Date of the note, YYYY-MM-DD. |
| note string required | string | Text of the note, 255 characters at most. |
| visibility string | string | personal (only you) or site (everyone with dashboard access). Default: site. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "plausible_write",
"arguments": {
"operation": "add_annotation",
"arguments": {
"site": "site",
"date": "date",
"note": "note"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"site": "acme-shop.example",
"date": "2026-10-14",
"note": "Launch email sent to 8,000 subscribers",
"visibility": "site",
"status": "added"
},
"isError": false
}