create_category
Create a new transaction category. Supports nested categories via parentId — child categories inherit the parent color if none is provided. Use when the user wants a new category to classify transactions. Requires finance:write scope.
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": {
"name": "<name>"
},
"name": "create_category"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| icon | No | Optional icon identifier for the category. | |
| name | Yes | Category name. | |
| type | No | Category type: "custom" (default, user-editable) or "internal" (system-managed). | |
| color | No | Hex color code (e.g. "#4CAF50"). Inherited from parent if omitted. | |
| parentId | No | ID of the parent category to create a subcategory. | |
| defaultTagIds | No | Tag IDs (from get_tags) that new transactions in this category get by default. Max 20 | |
| applyDefaultTagsOnAiCategorization | No | true also applies defaultTagIds when AI categorization picks this category |