create_report
Create a report for clear date/client/project/trip/category/merchant criteria. Tags group clients/projects/codes/trips; list_tags if unclear. excludePersonal=true excludes both Personal tag and Personal expense category, as in Report Wizard. Returns summary, exact report/Bill Client links, filters and a prefilled Report Wizard for visual criteria. Optional shareWith recipients (user-named only; emailed). No server preview: creates on call. Group-scoped reports exclude rows on other ordinary reports. No unreported matches: explain existing Reports; never duplicate. Use role-aware accountingHandoffUrls only for the requested destination; opening is not export proof. Complete directly; no check_compliance/get_report_details/tax/deductibility analysis before or after unless explicitly requested.
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": "create_report"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Existing ExpenseBot groups to include, such as a client, project, project code, property, or trip. Use list_tags first when uncertain. | |
| title | No | Custom report title | |
| dateRange | No | One period variant matching user wording. | |
| shareWith | No | Email addresses to share the report with | |
| categories | No | Optional configured expense categories to include in the report. | |
| excludedTags | No | Existing ExpenseBot groups to exclude from the report. | |
| recipientRole | No | Access for every shareWith recipient: reviewer for one-report review, comments, approval or changes; accountant only when the user explicitly wants ongoing report management and accounting-software access. | reviewer |
| excludePersonal | No | Exclude expenses whose Tag is Personal or whose Expense Category is Personal. | |
| excludedCategories | No | Expense categories to exclude from the report. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| success | Yes | ||
| reportId | No | ||
| reportUrl | No | ||
| finalAnswer | No | ||
| nextActions | No | ||
| billClientUrl | No | ||
| creationStatus | No | ||
| responseGuidance | No | ||
| accountingSetupUrl | No | ||
| accountingHandoffUrls | No |