Create expense
Creates an expense in a workspace with merchant, date, amount, currency and category.
MCP tool expensify_write → create_expense
write Confirm
Creates one expense in your account, not on a report yet. Category and tags must exist in the workspace (read them with get_workspace), and the expense can be marked reimbursable or billable. Returns the new expense ID; add a receipt with attach_receipt and put it on a report with add_expense_to_report. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| workspace string required | string | Workspace name or ID from list_workspaces, e.g. 'Acme Studio'. |
| amount number required | number | Amount as a decimal number, e.g. 42.50. |
| currency string required | string | Three-letter currency code, e.g. 'USD'. |
| merchant string required | string | Merchant name as on the receipt. |
| date date required | date | Date of the expense, YYYY-MM-DD. |
| category string | string | A category of the workspace, from get_workspace. |
| tags string[] | string[] | Tags of the workspace, from get_workspace. |
| description string | string | Short note shown on the expense. |
| reimbursable boolean | boolean | Default: true. |
| billable boolean | boolean | Default: false. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "expensify_write",
"arguments": {
"operation": "create_expense",
"arguments": {
"workspace": "Acme Studio",
"amount": 42.5,
"currency": "USD",
"merchant": "Blue Bottle Coffee",
"date": "2026-10-12",
"category": "Meals",
"description": "Coffee with client before the Northwind kickoff"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"expense_id": "T7f3a9c",
"workspace": "Acme Studio",
"merchant": "Blue Bottle Coffee",
"date": "2026-10-12",
"amount": 42.5,
"currency": "USD",
"category": "Meals",
"description": "Coffee with client before the Northwind kickoff",
"reimbursable": true,
"has_receipt": false,
"report_id": null,
"created_at": "2026-10-14T09:31:00+02:00"
},
"isError": false
}