Get Today
get_todayToday in the user's timezone: local date and time, today's events, Moments and Food Diary entries, and today's money totals by category. Use first when an agent needs the user's current day. ($0.05; API key required)
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_today"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | Optional ISO instant to read "today" at (defaults to now). | |
| currency | No | Optional 3-letter display currency for the money totals (default: the account's most used). | |
| timezone | No | Optional IANA zone of the user's device (e.g. Asia/Singapore). Used only when the account has no zone set; the profile zone wins. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| date | Yes | ||
| food | Yes | ||
| from | No | ||
| money | No | Today's money totals. | |
| counts | No | Rows returned per section. | |
| events | Yes | ||
| moments | Yes | ||
| timezone | Yes | ||
| truncated | No | true per section when more rows exist than were returned. | |
| local_time | No | ||
| unavailable | No |