scan_gmail_years
provider:outlook returns a handoff; never starts. Scan completed Gmail periods for receipts. In eligible split-tax-year accounts, a number is the period's ending year (2025 = 2024–25 tax year); otherwise it is a calendar year. Use returned tax-period labels and inclusive ISO bounds. Long-running: the first eligible period starts immediately; the rest queue one at a time (each full period typically takes hours; the app may close). Preview without confirmStart (no scan starts), ask the user to confirm, then start with confirmStart:true. For recent receipts (~60 days), use scan_gmail. The in-progress period cannot be year-scanned; use get_scan_status for progress.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"years": "<years>"
},
"name": "scan_gmail_years"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| years | Yes | Completed periods; ending year for eligible tax-year accounts (2025 = 2024–25), calendar year otherwise. Max 10. | |
| provider | No | Default Gmail. | |
| accountEmail | No | Optional: which connected Gmail inbox to scan (multi-inbox users). Defaults to the primary. | |
| confirmStart | No | Omit or false = preview only (no scan starts). Must be exactly true to start scanning. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | ||
| message | Yes | ||
| preview | No | ||
| success | Yes | ||
| eligible | No | ||
| gmailUrl | No | ||
| provider | No | ||
| scanning | No | ||
| notEligible | No | ||
| queuedYears | No | ||
| startedYear | No | ||
| alreadyQueued | No | ||
| scanInitiated | No | ||
| alreadyScanned | No | ||
| archiveThroughYear | No |