Get the annual allowance summary
Allowance, carry forward, time in lieu, leave used and remaining per person for one year.
MCP tool timetastic_read → get_annual_summary
read
Reads the Annual summary from Settings > Reporting & Backup and returns the Allowances sheet: allowance, brought forward, leave used, time in lieu and remaining per person. It does not return the Leave sheet; use get_monthly_summary for rows. The account must be able to open that page.
Parameters
| Name | Type | Description |
|---|---|---|
| year integer required | integer | Year such as 2026. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "timetastic_read",
"arguments": {
"operation": "get_annual_summary",
"arguments": {
"year": 1
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"year": 2026,
"unit": "days",
"people": [
{
"employee": "Ana Torres",
"allowance": 25,
"carried_forward": 3,
"used": 18,
"time_in_lieu": 0,
"remaining": 10
},
{
"employee": "Ben Okafor",
"allowance": 25,
"carried_forward": 0,
"used": 21,
"time_in_lieu": 1,
"remaining": 5
}
]
},
"isError": false
}