Life context for agents: get_context_pack + public notable packs. x402 + OAuth.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add an owned item to the user's private Inventory. For a computer, phone, camera or synth pass spec_template (computer.v1, phone.v1, camera.v1, synth.v1) and specs with that template's fields, taken from what the user says or the device reports; never infer specs from a model name. Changing facts (OS version, free space, battery, service readiness) go in state, one observation with observed_at. Never ask for or store device or account identifiers. Returns inventory_id and the item with capability_summary. Example: { name: "MacBook Pro 14 (2023)", spec_template: "computer.v1", specs: { manufacturer: "Apple", model_name: "MacBook Pro", model_identifier: "Mac15,11", chip: "Apple M3 Max", performance_cores: 10, efficiency_cores: 4, total_cores: 14, memory_bytes: 38654705664, memory: "36 GB", architecture: "arm64" }, state: { os: { name: "macOS", version: "15.4.1", build: "24E263" }, observed_at: "2026-09-29T14:00:00Z", source: "user_reported" } } ($0.10; API key required)
What the user calls the item, e.g. "MacBook Pro 14 (2023)".
Replaces the tag list.
Free text from the user.
Stable facts, by the template's field names (computer.v1: nickname, manufacturer, model_name, model_identifier, year, primary_uses, capability_tags, product_family, form_factor, chip, cpu, architecture, performance_cores, efficiency_cores, total_cores, threads, gpu, gpu_cores, gpu_memory_bytes, neural_engine_cores, memory_bytes, memory, storage_devices, display, ports). Merged per key on update; null removes a key; other keys are kept as written. Only what the user or the device says, never inferred from a model name. Never device or account identifiers.
Changing facts, as one observation: observed_at (ISO, default now), source (e.g. user_reported, system_profiler), confidence (0-1), and values such as os { name, version, build }, available_storage_bytes, battery, security { sip, gatekeeper, filevault }, services { bluebubbles: { installed_version, running, configured, blockers, checked_at } }. Merged per key; a key observed more recently is kept. Never changes specs or notes. Never device or account identifiers.
Default owned. To archive, use archive_inventory_item.
Specific kind: laptop, sweatshirt, guitar. Alias: item_type.
electronics | instruments | clothing | shoes | bags | accessories | jewelry | watches | collectibles | sports | health | home | tools | vehicles | furniture | other. Computers, phones and cameras are electronics; synths are instruments. Defaults to the spec_template's category, else other.
ISO 4217, e.g. USD, SGD. Default USD.
Where it is kept.
Alias for subtype (the stored column).
Contacts to link: purchased_from, or inherited_from when acquisition_type is inheritance.
Client idempotency key (retries return original result).
YYYY-MM-DD it came into the user's life (gift, inheritance). add_inventory_item also stores it as purchase_date when none is given.
Shop or person it came from.
Alias for estimated_value (the stored column).
YYYY-MM-DD
Which typed fields specs uses. Templates are listed in docs/MCP_LIFE_GRAPH.md. null (update) clears it.
What it is worth now. Alias: current_value.
Alias for request_id.
purchase | gift | inheritance | …
Manufacturer reference or model number (e.g. a watch reference).
0-1, when the subtype is a guess.
Layout of specs and state. Only 1 (the default).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Add an owned item to the user's private Inventory. For a computer, phone, camera or synth pass spec_template (computer.v1, phone.v1, camera.v1, synth.v1) and specs with that template's fields, taken from what the user says or the device reports; never infer specs from a model name. Changing facts (OS version, free space, battery, service readiness) go in state, one observation with observed_at. Never ask for or store device or account identifiers. Returns inventory_id and the item with capability_summary. Example: { name: "MacBook Pro 14 (2023)", spec_template: "computer.v1", specs: { manufacturer: "Apple", model_name: "MacBook Pro", model_identifier: "Mac15,11", chip: "Apple M3 Max", performance_cores: 10, efficiency_cores: 4, total_cores: 14, memory_bytes: 38654705664, memory: "36 GB", architecture: "arm64" }, state: { os: { name: "macOS", version: "15.4.1", build: "24E263" }, observed_at: "2026-09-29T14:00:00Z", source: "user_reported" } } ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| name* | string | What the user calls the item, e.g. "MacBook Pro 14 (2023)". |
| tags | array | Replaces the tag list. |
| brand | string | |
| model | string | |
| notes | string | Free text from the user. |
| specs | object | Stable facts, by the template's field names (computer.v1: nickname, manufacturer, model_name, model_identifier, year, primary_uses, capability_tags, product_family, form_factor, chip, cpu, architecture, performance_cores, efficiency_cores, total_cores, threads, gpu, gpu_cores, gpu_memory_bytes, neural_engine_cores, memory_bytes, memory, storage_devices, display, ports). Merged per key on update; null removes a key; other keys are kept as written. Only what the user or the device says, never inferred from a model name. Never device or account identifiers. |
| state | object | Changing facts, as one observation: observed_at (ISO, default now), source (e.g. user_reported, system_profiler), confidence (0-1), and values such as os { name, version, build }, available_storage_bytes, battery, security { sip, gatekeeper, filevault }, services { bluebubbles: { installed_version, running, configured, blockers, checked_at } }. Merged per key; a key observed more recently is kept. Never changes specs or notes. Never device or account identifiers. |
| status | string | Default owned. To archive, use archive_inventory_item. |
| subtype | string | Specific kind: laptop, sweatshirt, guitar. Alias: item_type. |
| category | string | electronics | instruments | clothing | shoes | bags | accessories | jewelry | watches | collectibles | sports | health | home | tools | vehicles | furniture | other. Computers, phones and cameras are electronics; synths are instruments. Defaults to the spec_template's category, else other. |
| currency | string | ISO 4217, e.g. USD, SGD. Default USD. |
| location | string | Where it is kept. |
| condition | string | |
| item_type | string | Alias for subtype (the stored column). |
| person_ids | array | Contacts to link: purchased_from, or inherited_from when acquisition_type is inheritance. |
| request_id | string | Client idempotency key (retries return original result). |
| acquired_date | string | YYYY-MM-DD it came into the user's life (gift, inheritance). add_inventory_item also stores it as purchase_date when none is given. |
| acquired_from | string | Shop or person it came from. |
| current_value | number | Alias for estimated_value (the stored column). |
| purchase_date | string | YYYY-MM-DD |
| spec_template | string | Which typed fields specs uses. Templates are listed in docs/MCP_LIFE_GRAPH.md. null (update) clears it. |
| purchase_price | number | |
| estimated_value | number | What it is worth now. Alias: current_value. |
| idempotency_key | string | Alias for request_id. |
| acquisition_type | string | purchase | gift | inheritance | … |
| reference_number | string | Manufacturer reference or model number (e.g. a watch reference). |
| subtype_confidence | number | 0-1, when the subtype is a guess. |
| specs_schema_version | integer | Layout of specs and state. Only 1 (the default). |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "What the user calls the item, e.g. \"MacBook Pro 14 (2023)\"."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replaces the tag list."
},
"brand": {
"type": "string"
},
"model": {
"type": "string"
},
"notes": {
"type": "string",
"description": "Free text from the user."
},
"specs": {
"type": "object",
"description": "Stable facts, by the template's field names (computer.v1: nickname, manufacturer, model_name, model_identifier, year, primary_uses, capability_tags, product_family, form_factor, chip, cpu, architecture, performance_cores, efficiency_cores, total_cores, threads, gpu, gpu_cores, gpu_memory_bytes, neural_engine_cores, memory_bytes, memory, storage_devices, display, ports). Merged per key on update; null removes a key; other keys are kept as written. Only what the user or the device says, never inferred from a model name. Never device or account identifiers."
},
"state": {
"type": "object",
"description": "Changing facts, as one observation: observed_at (ISO, default now), source (e.g. user_reported, system_profiler), confidence (0-1), and values such as os { name, version, build }, available_storage_bytes, battery, security { sip, gatekeeper, filevault }, services { bluebubbles: { installed_version, running, configured, blockers, checked_at } }. Merged per key; a key observed more recently is kept. Never changes specs or notes. Never device or account identifiers."
},
"status": {
"enum": [
"wishlist",
"ordered",
"owned",
"listed_for_sale",
"sold",
"returned",
"lost",
"disposed",
"donated"
],
"type": "string",
"description": "Default owned. To archive, use archive_inventory_item."
},
"subtype": {
"type": "string",
"description": "Specific kind: laptop, sweatshirt, guitar. Alias: item_type."
},
"category": {
"type": "string",
"description": "electronics | instruments | clothing | shoes | bags | accessories | jewelry | watches | collectibles | sports | health | home | tools | vehicles | furniture | other. Computers, phones and cameras are electronics; synths are instruments. Defaults to the spec_template's category, else other."
},
"currency": {
"type": "string",
"description": "ISO 4217, e.g. USD, SGD. Default USD."
},
"location": {
"type": "string",
"description": "Where it is kept."
},
"condition": {
"enum": [
"new",
"excellent",
"good",
"worn",
"needs_repair",
"retired"
],
"type": "string"
},
"item_type": {
"type": "string",
"description": "Alias for subtype (the stored column)."
},
"person_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Contacts to link: purchased_from, or inherited_from when acquisition_type is inheritance."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"acquired_date": {
"type": "string",
"description": "YYYY-MM-DD it came into the user's life (gift, inheritance). add_inventory_item also stores it as purchase_date when none is given."
},
"acquired_from": {
"type": "string",
"description": "Shop or person it came from."
},
"current_value": {
"type": "number",
"description": "Alias for estimated_value (the stored column)."
},
"purchase_date": {
"type": "string",
"description": "YYYY-MM-DD"
},
"spec_template": {
"enum": [
"computer.v1",
"phone.v1",
"camera.v1",
"synth.v1"
],
"type": "string",
"description": "Which typed fields specs uses. Templates are listed in docs/MCP_LIFE_GRAPH.md. null (update) clears it."
},
"purchase_price": {
"type": "number"
},
"estimated_value": {
"type": "number",
"description": "What it is worth now. Alias: current_value."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"acquisition_type": {
"type": "string",
"description": "purchase | gift | inheritance | …"
},
"reference_number": {
"type": "string",
"description": "Manufacturer reference or model number (e.g. a watch reference)."
},
"subtype_confidence": {
"type": "number",
"description": "0-1, when the subtype is a guess."
},
"specs_schema_version": {
"type": "integer",
"description": "Layout of specs and state. Only 1 (the default)."
}
},
"additionalProperties": false
}Append a valuation (value, currency, valued_at, source) to one owned Inventory item; the item's current value becomes this value. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| notes | string | |
| value* | number | What it is worth. |
| source | string | Where the value comes from: appraisal, listing, estimate, … |
| currency | string | ISO 4217, default USD. |
| valued_at | string | ISO date or date-time; default now. |
| confidence | number | 0-1 |
| request_id | string | Client idempotency key (retries return original result). |
| inventory_id* | string | The item id from add_inventory_item, get_inventory or search_inventory. |
| idempotency_key | string | Alias for request_id. |
Add owned contacts to a contact list (list_id, or list_name as its name or slug). Returns added, already_member and not_found (ids that aren't the owner's contacts); a repeat adds nothing. create_if_missing=true creates a list named list_name first. Family follows relationships and is refused (code AUTO_SYNCED_LIST): set the relationship with update_person. undo_contact_change(change_id) removes the ones added. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| list_id | string | Contact list id from list_contact_lists. |
| list_name | string | Contact list name or slug, when list_id is not known. |
| person_ids* | array | Contact ids (at most 500). |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
| create_if_missing | boolean | Create the list named list_name if it does not exist (default false). |
{
"type": "object",
"required": [
"person_ids"
],
"properties": {
"list_id": {
"type": "string",
"description": "Contact list id from list_contact_lists."
},
"list_name": {
"type": "string",
"description": "Contact list name or slug, when list_id is not known."
},
"person_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Contact ids (at most 500)."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"create_if_missing": {
"type": "boolean",
"description": "Create the list named list_name if it does not exist (default false)."
}
},
"additionalProperties": false
}Add a nickname/payment handle/misspelling alias for one CRM person. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| alias* | string | |
| source | string | |
| person_id* | string | |
| alias_kind | string | |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"person_id",
"alias"
],
"properties": {
"alias": {
"type": "string"
},
"source": {
"type": "string"
},
"person_id": {
"type": "string"
},
"alias_kind": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Correct or dispute an event fact from a saved answer. Inspect its source first. Supply request_id for safe retries. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| value | string | Required when action is correct. |
| action* | string | |
| message_id* | string | |
| request_id* | string | |
| source_ref* | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"message_id",
"source_ref",
"action",
"request_id"
],
"properties": {
"value": {
"type": "string",
"maxLength": 500,
"description": "Required when action is correct."
},
"action": {
"enum": [
"correct",
"not_true_anymore"
],
"type": "string"
},
"message_id": {
"type": "string"
},
"request_id": {
"type": "string"
},
"source_ref": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Preview first, 30-day undo. Soft-delete an asset (sets archived_at). Original rows are preserved for versioning. Reviewed and reversible: first call preview_destructive_change({ tool: "archive_asset", arguments: { asset_id } }), which stores the exact change without applying it. After the user confirms, call archive_asset with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| asset_id* | string | |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged* | boolean | Must be true after reviewing the preview and its 30-day restore window. |
{
"type": "object",
"required": [
"asset_id",
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"asset_id": {
"type": "string"
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}Reversibly archive one owned event; preserve linked data and return restore_id. Archived rows are never purged, so restore_event works for at least 30 days (the Dayze destructive-change restore window). Use a new request_id for each intended action. ($0; API key required)
| Argument | Type | Description |
|---|---|---|
| reason | string | |
| event_id* | string | |
| request_id* | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"event_id",
"request_id"
],
"properties": {
"reason": {
"type": "string"
},
"event_id": {
"type": "string"
},
"request_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Reversibly archive one owned expense; preserve linked data and return restore_id. Archived rows are never purged, so restore_expense works for at least 30 days (the Dayze destructive-change restore window). Use a new request_id for each intended action. ($0; API key required)
| Argument | Type | Description |
|---|---|---|
| reason | string | |
| expense_id* | string | |
| request_id* | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"expense_id",
"request_id"
],
"properties": {
"reason": {
"type": "string"
},
"expense_id": {
"type": "string"
},
"request_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Preview first, 30-day undo. Archive an inventory item instead of deleting it (status archived, archived_at set; valuations, people links and photos are kept). Reviewed and reversible: first call preview_destructive_change({ tool: "archive_inventory_item", arguments: { inventory_id } }), which stores the exact change without applying it. After the user confirms, call archive_inventory_item with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| reason | string | Why it is archived (kept on the receipt). |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| inventory_id* | string | The item id from add_inventory_item, get_inventory or search_inventory. |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged* | boolean |
Reversibly archive one owned trip; preserve linked data and return restore_id. Archived rows are never purged, so restore_trip works for at least 30 days (the Dayze destructive-change restore window). Use a new request_id for each intended action. ($0; API key required)
| Argument | Type | Description |
|---|---|---|
| reason | string | |
| trip_id* | string | |
| request_id* | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"trip_id",
"request_id"
],
"properties": {
"reason": {
"type": "string"
},
"trip_id": {
"type": "string"
},
"request_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Attach an asset_id to one of your entities. An asset uploaded without an entity is attached as is; one already on an entity gets a linked copy (the original row stays). Roles: original | processed | thumbnail | cover | document | receipt | certificate | other (photo is stored as original). Legacy: pass url instead of asset_id. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| url | string | A web link (https://…) to an image. Not a storage path: upload a file, then attach its asset_id. |
| role | string | original | cover | thumbnail | … |
| asset_id | string | |
| metadata | object | Free-form metadata, merged into the stored metadata (metadata.source becomes the asset source). |
| entity_id* | string | |
| asset_type | string | |
| request_id | string | Client idempotency key (retries return original result). |
| description | string | Caption for the attached asset (kept on a linked copy too). |
| entity_type* | string |
MUTATES one Food Diary row the authenticated user owns by storing a meal photo on it (same pipeline as the web diary upload). Required: food_id (UUID from log_food / search) plus exactly one of image_base64 (raw base64 or data: URL) or url (public https image). JPEG, PNG, WebP, GIF, HEIC, or AVIF under 8 MB. One photo per entry: calling again replaces photo_url (replaced/previous_photo_url report it). EXIF capture time moves consumed_at unless keep_consumed_at=true. Unknown or other-user food_id returns not_found and stores nothing. Response photo_url is re-read from the row. Syncs the mirrored calendar event and rebuilds life_state. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.15; API key required)
| Argument | Type | Description |
|---|---|---|
| url | string | Public https image URL to fetch and store. Use this or image_base64. |
| food_id* | string | UUID of a Food Diary row the authenticated user owns |
| filename | string | Optional original filename |
| request_id | string | Client idempotency key (retries return original result). |
| image_base64 | string | Image bytes as base64 (optional data:image/...;base64, prefix). Use this or url. |
| idempotency_key | string | Alias for request_id. |
| keep_consumed_at | boolean |
CONTEXT LAYER: server-side contact hygiene. Returns compact candidate clusters only (duplicates, entity-type hints, normalization, payment-handle collisions, junk system/test-word names). Do NOT use get_people bulk dumps for cleanup. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| checks | array | |
| min_confidence | number |
{
"type": "object",
"properties": {
"limit": {
"type": "number"
},
"checks": {
"type": "array",
"items": {
"type": "string"
}
},
"min_confidence": {
"type": "number"
}
},
"additionalProperties": false
}Add human names to coord-only places/visits via Google nearby search + reverse geocode. Never overwrites existing names, coordinates, or user-entered fields. Idempotent; resumable via cursor under a per-account monthly Places quota. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| limit | number | Max targets this run (1–100, default 25). |
| cursor | string | Resume token from a previous next_cursor. |
| dry_run | boolean | |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Max targets this run (1–100, default 25)."
},
"cursor": {
"type": "string",
"description": "Resume token from a previous next_cursor."
},
"dry_run": {
"type": "boolean"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Preview first, 30-day undo. Dismiss non-person / typed junk from the clarification queue. Reviewed and reversible: first call preview_destructive_change({ tool: "bulk_dismiss_clarifications", arguments: { entity_type?, reason? } }), which stores the exact change without applying it. After the user confirms, call bulk_dismiss_clarifications with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. The preview lists every clarification that would be dismissed; restore returns them to pending. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| reason | string | |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| entity_type | string | |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged* | boolean | Must be true after reviewing the preview and its 30-day restore window. |
Set entity_type (person/company/merchant/…) on a CRM row without losing transactions or links. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| source | string | |
| entity_id | string | |
| person_id | string | |
| confidence | number | |
| request_id | string | Client idempotency key (retries return original result). |
| entity_type* | string | |
| idempotency_key | string | Alias for request_id. |
| identity_status | string |
{
"type": "object",
"required": [
"entity_type"
],
"properties": {
"source": {
"type": "string"
},
"entity_id": {
"type": "string"
},
"person_id": {
"type": "string"
},
"confidence": {
"type": "number"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"entity_type": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"identity_status": {
"type": "string"
}
},
"additionalProperties": false
}Atomically archive the exact reviewed preview. Requires preview_id, candidate_hash and request_id. Refuses changed sources. Returns per-row statuses and restore_id (restore_cleanup undoes it for at least 30 days); replay performs no additional actions. ($0; API key required)
| Argument | Type | Description |
|---|---|---|
| preview_id* | string | |
| request_id* | string | |
| candidate_hash* | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"preview_id",
"candidate_hash",
"request_id"
],
"properties": {
"preview_id": {
"type": "string"
},
"request_id": {
"type": "string"
},
"candidate_hash": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Read-only account audit and durable archive plan for events, expenses or trips. Returns source hashes, linked records, field differences, rollback payloads and a review queue. Review the exact candidate set before cleanup_apply. Preview expires after 30 minutes. ($0; API key required)
| Argument | Type | Description |
|---|---|---|
| family* | string | |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"family"
],
"properties": {
"family": {
"enum": [
"events",
"expenses",
"trips"
],
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Owner approve+commit via payload_hash + owner_session_id (flagged; off by default). Requires the propose_life_update review first. Commits append bitemporal revisions and keep prior revisions; there is no post-commit undo tool, so correct a committed fact with a new propose_life_update. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| request_id | string | |
| proposal_id* | string | |
| payload_hash* | string | |
| idempotency_key | string | |
| owner_session_id* | string |
{
"type": "object",
"required": [
"proposal_id",
"payload_hash",
"owner_session_id"
],
"properties": {
"request_id": {
"type": "string"
},
"proposal_id": {
"type": "string"
},
"payload_hash": {
"type": "string"
},
"idempotency_key": {
"type": "string"
},
"owner_session_id": {
"type": "string"
}
},
"additionalProperties": false
}Side-by-side notable packs for two slugs (life_in_days + day_number timelines). One call instead of two notable_pack. Example: elon-musk vs steve-jobs. ($0.08)
| Argument | Type | Description |
|---|---|---|
| date | string | YYYY-MM-DD target date for both packs |
| peers | number | |
| slug_a* | string | First person slug |
| slug_b* | string | Second person slug |
| similar | number |
{
"type": "object",
"required": [
"slug_a",
"slug_b"
],
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD target date for both packs"
},
"peers": {
"type": "number",
"default": 6
},
"slug_a": {
"type": "string",
"description": "First person slug"
},
"slug_b": {
"type": "string",
"description": "Second person slug"
},
"similar": {
"type": "number",
"default": 4
}
},
"additionalProperties": false
}Preview first, 30-day undo. Convert a contact’s entity_type (same as classify_contact). Preserves FKs. Reviewed and reversible: first call preview_destructive_change({ tool: "convert_contact_entity", arguments: { person_id, target_type } }), which stores the exact change without applying it. After the user confirms, call convert_contact_entity with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. Restore reverts entity_type, identity_status and identity_confidence. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| entity_id | string | |
| person_id | string | |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| target_type | string | |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged |
Preview first, 30-day undo. Remove one exact false atom from a bundled memory, retaining the other text and clearing its stale embedding. Reviewed and reversible: first call preview_destructive_change({ tool: "correct_memory_atom", arguments: { memory_id, false_atom } }), which stores the exact change without applying it. After the user confirms, call correct_memory_atom with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| memory_id | string | Memory id, checked against the preview. |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged* | boolean | Must be true after reviewing the preview and its 30-day restore window. |
{
"type": "object",
"required": [
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"memory_id": {
"type": "string",
"description": "Memory id, checked against the preview."
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}Add a private condition for an explicit subject_type: self, or person plus an owned person_id from get_people/resolve_person. Never turn a family member's condition into self; if the person is unresolved, ask and write nothing. status defaults suspected—never infer active or confirmed from a mention. Keep the user's words; source defaults user_reported and confirmation_status reported. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| name* | string | What the user calls it, in their words (e.g. "Blurry near vision"). Never a diagnosis they did not give. |
| notes | string | |
| source | string | Provenance, e.g. user_reported. Default user_reported. |
| status | string | suspected (default for a new one) | active | improving | resolved. |
| symptoms | string | What they notice, e.g. "Blurry at near distance, worse in the evening". |
| body_area | string | Where, e.g. "Left eye". |
| person_id | string | Owned contact id; required for person. |
| request_id | string | Client idempotency key (retries return original result). |
Create a contact list by name. A list whose slug matches is returned unchanged (created=false), so a repeat creates nothing. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| name* | string | List name, e.g. "Book club". |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "List name, e.g. \"Book club\"."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Pending Replies (Inbox): save a reply the user owes someone, e.g. 'what to reply to X', 'I owe X a reply'. Use this, not log_event or a task. Optional draft (the reply text), summary (one line in your own words; never the email body, subject or sender), channel, category, received_at, and source { kind, thread_id, message_id } (ids only). Links the contact only when resolve_person finds exactly one (or pass person_id); otherwise the reply is saved unlinked and person_link says why. An unsent reply for the same thread or person comes back instead of a second one (created: false, deduplicated: true); update_existing: true replaces its draft and summary. Never sends anything. Requires API key or OAuth with context.write; share tokens cannot write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| draft | string | The reply text to send later, max 20,000 characters. Replaces the saved draft; empty or null clears. Alias: draft_message. |
| source | object | The email the reply answers, as ids only (e.g. a search_gmail id is a message_id). Never a subject, sender or text. On update, null clears it. |
| channel | string | Where to reply: whatsapp, email, sms, call, imessage, telegram, instagram, facebook, signal, linkedin, twitter, slack, reddit, teams, work_email, zoom, dayze, other; the platform the conversation is on (a Reddit thread is reddit, an Instagram group instagram). Default email when source is set, else other. |
| summary | string | One line (max 280) in your own words: what the reply is about. Never paste the email body, subject line or sender address. |
| category | string |
Add a Dayze Contacts record, birthday included (YYYY-MM-DD, YYYY-MM, YYYY, or MM-DD if year unknown); checks duplicates first. An existing contact comes back unchanged with its person_id, not_applied (the fields you sent) and a hint. request_id is optional: without one, identical calls within 15 minutes return the first result. Advertised name create_person is stable; tools/call also accepts create_contact. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| tier | string | |
| string | ||
| notes | string | |
| phone | string | |
| aliases | array | |
| wallets | array | PHI-930: ENS (.eth) / SNS (.sol) names and/or addresses for this contact. Stored in social_handles (legacy ens/ens_address kept). |
| birthday | string | YYYY-MM-DD, YYYY-MM, YYYY, or MM-DD / --MM-DD when the year is unknown (same as update_person) |
| request_id | string | Client idempotency key (retries return original result). |
Save a venue card (business_contacts): address, opening_hours, affordability ($/$$/$$$), notes, tags. Idempotent by name or idempotency_key — does not create calendar notes. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| area | string | |
| city | string | |
| name* | string | |
| tags | array | |
| hours | string | Alias for opening_hours |
| notes | string | |
| phone | string | |
| address | string | |
| country | string | |
| website | string | |
| category | string | restaurant|cafe|supermarket|shop|hawker|… (aliases mapped to business_contacts.category) |
Reversibly archives one owned event. Required event_id and request_id. Returns the prior row in deleted for compatibility, changed, restore_id and life_state_rebuilt. All food, people and asset links are preserved. Restore with restore_event. Replays perform no additional action. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| event_id* | string | UUID of a calendar event the authenticated user owns |
| request_id* | string | Required client idempotency key; a replay returns the first result. |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"event_id",
"request_id"
],
"properties": {
"event_id": {
"type": "string",
"description": "UUID of a calendar event the authenticated user owns"
},
"request_id": {
"type": "string",
"description": "Required client idempotency key; a replay returns the first result."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Preview first, 30-day undo. Removes one Food Diary row the authenticated user owns and archives its mirrored calendar event. Prefer this over delete_event for meals logged via log_food. Unknown or other-user food_id returns an error. Rebuilds life_state. Reviewed and reversible: first call preview_destructive_change({ tool: "delete_food", arguments: { food_id } }), which stores the exact change without applying it. After the user confirms, call delete_food with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. Requires API key or OAuth with context.delete. Share tokens cannot write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| food_id* | string | UUID of a Food Diary row the authenticated user owns |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged* | boolean | Must be true after reviewing the preview and its 30-day restore window. |
Preview first, 30-day undo. Removes Dayze Agent memories the authenticated user owns: memory_id (or up to 50 memory_ids) from get_memories. Rows get_memories marks source "event" are calendar events (use delete_event). An unknown or other-user id is not found and nothing changes. Dayze chat and get_memories stop using them at once; rebuilds life_state. Reviewed and reversible: first call preview_destructive_change({ tool: "delete_memory", arguments: { memory_id } }), which stores the exact change without applying it. After the user confirms, call delete_memory with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. Requires API key or OAuth with context.delete. Share tokens cannot write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| memory_id | string | Optional: the memory the preview named (checked against it). A preview of several memory_ids names none. |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged* | boolean |
Preview first, 30-day undo. Reviewed and reversible: first call preview_destructive_change({ tool: "delete_moment", arguments: { moment_id } }), which stores the exact change without applying it. After the user confirms, call delete_moment with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| moment_id | string | |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged* | boolean | Must be true after reviewing the preview and its 30-day restore window. |
{
"type": "object",
"required": [
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"moment_id": {
"type": "string"
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}Read a Moment and linked impact and store a reviewed deletion preview; nothing is removed. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| moment_id* | string | |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"moment_id"
],
"properties": {
"moment_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Delete one owned contact only after delete_person_preview. Preserves a complete restore snapshot for 30 days; undo with undo_contact_change using restore_id. Requires a request_id for retry-safe idempotency. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| person_id* | string | UUID of the owned contact to delete. |
| preview_id* | string | Durable preview_id returned by delete_person_preview. |
| request_id* | string | Required idempotency key; retries return the original result. |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged* | boolean | Must be true after reviewing the 30-day restore window. |
{
"type": "object",
"required": [
"person_id",
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"person_id": {
"type": "string",
"description": "UUID of the owned contact to delete."
},
"preview_id": {
"type": "string",
"description": "Durable preview_id returned by delete_person_preview."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original result."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the 30-day restore window."
}
},
"additionalProperties": false
}Create a durable, non-mutating snapshot of one owned contact and every linked record before deletion. Review the 30-day restore window, then pass preview_id to delete_person. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| person_id* | string | UUID of the owned contact to review. |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"person_id"
],
"properties": {
"person_id": {
"type": "string",
"description": "UUID of the owned contact to review."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Preview first, 30-day undo. Delete a saved place card (business_contacts) by place_id / business_contact_id and return the deleted card. Reviewed and reversible: first call preview_destructive_change({ tool: "delete_place", arguments: { place_id } }), which stores the exact change without applying it. After the user confirms, call delete_place with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. Restore also re-links visits, events, expenses and people that pointed at the card. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| id | string | |
| place_id | string | |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| idempotency_key | string | Alias for request_id. |
| business_contact_id | string | |
| restore_window_acknowledged* |
Preview first, 30-day undo. Delete one place_visits row (visit_id from get_place_visits or log_place_visit) without deleting its canonical place. Reviewed and reversible: first call preview_destructive_change({ tool: "delete_place_visit", arguments: { visit_id } }), which stores the exact change without applying it. After the user confirms, call delete_place_visit with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| visit_id* | string | UUID of a place_visits row: visit_id from get_place_visits or log_place_visit. |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged* | boolean | Must be true after reviewing the preview and its 30-day restore window. |
Dismiss a pending entity clarification (not_person, etc.). ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| reason | string | |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
| clarification_id* | string |
{
"type": "object",
"required": [
"clarification_id"
],
"properties": {
"reason": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"clarification_id": {
"type": "string"
}
},
"additionalProperties": false
}Optional Google Places fill for a saved place card (hours/address/phone/website). Defaults to fill_empty_only — does not overwrite agent-supplied fields. Returns a clear not_configured capability error if GOOGLE_PLACES_API_KEY (or GOOGLE_MAPS_API_KEY) is missing. ($0.15; API key required)
| Argument | Type | Description |
|---|---|---|
| place_id | string | |
| request_id | string | Client idempotency key (retries return original result). |
| fill_empty_only | boolean | |
| idempotency_key | string | Alias for request_id. |
| business_contact_id | string |
{
"type": "object",
"properties": {
"place_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"fill_empty_only": {
"type": "boolean"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"business_contact_id": {
"type": "string"
}
},
"additionalProperties": false
}Return evidence/provenance for a claim: polaris_learned_facts, life_events / life_event_relationships when present, then memories. Use when the agent must cite why it believes something — do not invent sources. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| fact | string | Alias for query |
| limit | number | Max evidence rows 1–20, default 8 |
| query* | string | Fact or phrase to explain |
{
"type": "object",
"required": [
"query"
],
"properties": {
"fact": {
"type": "string",
"description": "Alias for query"
},
"limit": {
"type": "number",
"description": "Max evidence rows 1–20, default 8"
},
"query": {
"type": "string",
"description": "Fact or phrase to explain"
}
},
"additionalProperties": false
}Compact identity resolution candidates by person_id or query (alias/name/payment signals). Prefer over bulk get_people. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| query | string | |
| person_id | string |
{
"type": "object",
"properties": {
"limit": {
"type": "number"
},
"query": {
"type": "string"
},
"person_id": {
"type": "string"
}
},
"additionalProperties": false
}Fetch one asset by asset_id with signed_url for download/processing. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| asset_id* | string | |
| include_signed_url | boolean |
{
"type": "object",
"required": [
"asset_id"
],
"properties": {
"asset_id": {
"type": "string"
},
"include_signed_url": {
"type": "boolean"
}
},
"additionalProperties": false
}Read-only owner view of the 2012–2015 Berklee email archive: per-person first/last cited contact, imported message volume, explicitly stored courses/projects, and email-anchor versus name-only provenance. Optional exact course, term, and project filters. Every cited event carries an inspect_url. Volume is not closeness; silence is not interpreted. Identity-document, health, and legal records are excluded. ($0.15; API key required)
| Argument | Type | Description |
|---|---|---|
| term | string | Exact term facet, e.g. Fall 2014. |
| course | string | Exact stored course facet. |
| project | string | Exact stored project facet. |
{
"type": "object",
"properties": {
"term": {
"type": "string",
"description": "Exact term facet, e.g. Fall 2014."
},
"course": {
"type": "string",
"description": "Exact stored course facet."
},
"project": {
"type": "string",
"description": "Exact stored project facet."
}
},
"additionalProperties": false
}Canonical cities from confirmed/completed trips only (excludes soft pins / status=possible). Inference requires category=travel + structured location — not todo titles. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | |
| from | string |
{
"type": "object",
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
}
},
"additionalProperties": false
}Private health conditions owned by the user, for subject_type self (default) or an explicitly resolved Dayze Contacts person_id. A person condition never appears in the user's self list. status: open (default), suspected, active, improving, resolved or all. condition_id returns recent check-ins and care items for the same subject. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| status | string | open (default: every condition not resolved), one status, or all. |
| person_id | string | Owned contact id; required for person. |
| condition_id | string | One condition, with its recent check-ins and care items. |
| subject_type | string | self, or person with person_id. |
{
"type": "object",
"properties": {
"status": {
"enum": [
"open",
"suspected",
"active",
"improving",
"resolved",
"all"
],
"type": "string",
"description": "open (default: every condition not resolved), one status, or all."
},
"person_id": {
"type": "string",
"description": "Owned contact id; required for person."
},
"condition_id": {
"type": "string",
"description": "One condition, with its recent check-ins and care items."
},
"subject_type": {
"enum": [
"self",
"person"
],
"type": "string",
"description": "self, or person with person_id."
}
},
"additionalProperties": false
}Life Context pack for one Dayze account (`account` names it — with more than one Dayze connection, say which account you are answering from): identity, pulse, people, next actions, memories, quizzes, recent consented place visits, and traced facts. Use include_*=false to omit default sections; current location and money stay opt-in. Spec: https://dayze.com/docs/life-context Records carry inspect_url (their Dayze page): cite with it, never build a link from an id; a record without one has no page (inspect_note says which). ($0.20; API key required)
| Argument | Type | Description |
|---|---|---|
| q | string | Alias for query. |
| at | string | ISO date-time to answer as of (default now), e.g. 2026-09-26T09:00:00+08:00. |
| focus | string | Optional focus hint echoed in the pack (e.g. places, travel, people) |
| query | string | Question that guides facts and memories. |
| timezone | string | IANA time zone for today (default: where the user is now, else their home zone). |
| include_money | boolean | Include the private cashflow summary |
| include_trips | boolean | Include recent/upcoming trips from completed travel history |
Canonical countries from completed trips (not other people travel). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | |
| from | string | |
| include_residence | boolean |
{
"type": "object",
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"include_residence": {
"type": "boolean"
}
},
"additionalProperties": false
}Permitted assertion states for a person (flagged life-graph; off by default). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| known_at | string | |
| valid_at | string | |
| people_id | string | CRM people.id UUID |
| person_id | string | Alias for people_id |
| predicates | array |
{
"type": "object",
"properties": {
"known_at": {
"type": "string"
},
"valid_at": {
"type": "string"
},
"people_id": {
"type": "string",
"description": "CRM people.id UUID"
},
"person_id": {
"type": "string",
"description": "Alias for people_id"
},
"predicates": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}List assets linked to an entity (role, signed_url, versions). entity_type inventory_item → inventory. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| entity_id* | string | |
| asset_type | string | |
| entity_type* | string |
{
"type": "object",
"required": [
"entity_type",
"entity_id"
],
"properties": {
"entity_id": {
"type": "string"
},
"asset_type": {
"type": "string"
},
"entity_type": {
"type": "string"
}
},
"additionalProperties": false
}List graph edges for an event, trip, place, or person. Each link has a confirmation: explicit | pending | confirmed | rejected. A rejected link is listed only as a record of the decision: it is not a relationship, and every other read leaves it out. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| entity_id* | string | |
| entity_type* | string |
{
"type": "object",
"required": [
"entity_type",
"entity_id"
],
"properties": {
"entity_id": {
"type": "string"
},
"entity_type": {
"type": "string"
}
},
"additionalProperties": false
}Inspect an event fact from a saved Dayze answer before correcting it. Requires calendar read and travel details access. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| message_id* | string | Saved assistant answer message UUID. |
| source_ref* | string | events:<id> or event_people:<id> from that answer. |
{
"type": "object",
"required": [
"message_id",
"source_ref"
],
"properties": {
"message_id": {
"type": "string",
"description": "Saved assistant answer message UUID."
},
"source_ref": {
"type": "string",
"description": "events:<id> or event_people:<id> from that answer."
}
},
"additionalProperties": false
}Authenticated user's calendar events. Prefer explicit from/to (YYYY-MM-DD). Shortcuts: today|week|month|year (calendar year)|decade. Browsing noise excluded by default. Records carry inspect_url (their Dayze page): cite with it, never build a link from an id; a record without one has no page (inspect_note says which). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| at | string | ISO date-time to answer as of (default now), e.g. 2026-09-26T09:00:00+08:00. |
| to | string | Inclusive YYYY-MM-DD |
| from | string | Inclusive YYYY-MM-DD (preferred over range) |
| kinds | array | Filter by event_kind: life_event, calendar_block, todo, goal, travel_segment, food_log, health_record, transaction, media_log, work, family, personal. Alias "food" (also meal/drink/snack) matches the displayed Food category: food_log rows plus Meal/Drink/Snack life_events. total/has_more count only matching rows. |
| limit | number | |
| query | string | Literal substring in title, description or location. |
| range | string | |
| cursor | string |
Authenticated user cashflow summary: spend, income, net, and top spend categories. Requires OAuth or a supported scoped credential. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| period | string | Summary window. Default month. |
{
"type": "object",
"properties": {
"period": {
"enum": [
"month",
"year"
],
"type": "string",
"description": "Summary window. Default month."
}
},
"additionalProperties": false
}Money for a civil date range in the account timezone (max 366 days; default today): total spent and income in one display currency (the same aggregation as Dayze chat; transfers and IOU anchors left out, rows without an FX quote listed separately, never converted 1:1), plus totals by category and by currency. Optional category matches the expense category (e.g. "food"). Individual transactions are included only with the Financial details permission. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| at | string | Optional ISO instant to read "today" at (defaults to now). |
| to | string | Last civil day, YYYY-MM-DD, inclusive. |
| date | string | Alias for from (one day). |
| from | string | First civil day, YYYY-MM-DD, in the account timezone. Alone = that one day. Default: today. |
| category | string | Optional expense category to total, matched case-insensitively (e.g. food, transport). |
| currency | string | Optional 3-letter display currency (e.g. SGD). |
| timezone | string | 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. |
Food Diary entries (what, kind, place, local time, dishes, photo) for a civil date range in the account timezone (max 92 days; default today), oldest first. Optional place narrows to one venue. Each entry has food_id. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| at | string | Optional ISO instant to read "today" at (defaults to now). |
| to | string | Last civil day, YYYY-MM-DD, inclusive. |
| date | string | Alias for from (one day). |
| from | string | First civil day, YYYY-MM-DD, in the account timezone. Alone = that one day. Default: today. |
| place | string | Optional venue or merchant to match. |
| timezone | string | 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. |
{
"type": "object",
"required": [],
"properties": {
"at": {
"type": "string",
"description": "Optional ISO instant to read \"today\" at (defaults to now)."
},
"to": {
"type": "string",
"description": "Last civil day, YYYY-MM-DD, inclusive."
},
"date": {
"type": "string",
"description": "Alias for from (one day)."
},
"from": {
"type": "string",
"description": "First civil day, YYYY-MM-DD, in the account timezone. Alone = that one day. Default: today."
},
"place": {
"type": "string",
"description": "Optional venue or merchant to match."
},
"timezone": {
"type": "string",
"description": "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."
}
},
"additionalProperties": false
}Structured fundraising CRM: source-backed roles, sector and stage fit, pipeline and existing graph intro paths. Use for who to approach for a round. Returns canonical person IDs. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| view | string | |
| stage | string | |
| sector | string | |
| status | string | |
| strength | number |
{
"type": "object",
"properties": {
"view": {
"enum": [
"investors",
"intro_sources"
],
"type": "string"
},
"stage": {
"type": "string"
},
"sector": {
"type": "string"
},
"status": {
"enum": [
"research",
"intro_requested",
"contacted",
"meeting",
"diligence",
"passed",
"committed"
],
"type": "string"
},
"strength": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
}Read private health trend points for self (default), or for an explicit person subject through condition_id. Effective points only by default; include_superseded returns corrections. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| kind | string | |
| limit | integer | Default 100. |
| person_id | string | Owned contact id; required for person. |
| observed_to | string | Inclusive ISO timestamp. |
| condition_id | string | From get_conditions or create_condition. |
| subject_type | string | self, or person with person_id. |
| observed_from | string | Inclusive ISO timestamp. |
| include_superseded | boolean | Default false. True includes correction history. |
{
"type": "object",
"properties": {
"kind": {
"enum": [
"symptom",
"treatment",
"energy",
"sleep"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Default 100."
},
"person_id": {
"type": "string",
"description": "Owned contact id; required for person."
},
"observed_to": {
"type": "string",
"description": "Inclusive ISO timestamp."
},
"condition_id": {
"type": "string",
"description": "From get_conditions or create_condition."
},
"subject_type": {
"enum": [
"self",
"person"
],
"type": "string",
"description": "self, or person with person_id."
},
"observed_from": {
"type": "string",
"description": "Inclusive ISO timestamp."
},
"include_superseded": {
"type": "boolean",
"description": "Default false. True includes correction history."
}
},
"additionalProperties": false
}Bounded graph read over life_updates (PHI-54/61): traverse interaction → person/event/expense/place with source/confidence on every hop. When life_update edges are missing, projects hops from CRM interactions, event_people, and expense person FKs (PHI-100). Prefer for “who was I with at X?”, “when am I meeting Y next?”, “how much at Z?”. 93-day default window. Pass person_name, place_query, or ids. Records carry inspect_url (their Dayze page): cite with it, never build a link from an id; a record without one has no page (inspect_note says which). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | Inclusive YYYY-MM-DD |
| from | string | Inclusive YYYY-MM-DD |
| limit | number | Max 1–50, default 25 |
| event_id | string | |
| place_id | string | |
| person_id | string | |
| expense_id | string | |
| person_name | string | |
| place_query |
Browse the user's owned Inventory: filter by category, status or search text (name, brand, model, notes, reference number). Archived and no-longer-owned items only with include_archived. Items with specs carry capability_summary and state_freshness; each item has photo_count and cover_url. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| limit | number | 1-200, default 50 |
| offset | number | |
| search | string | Match name, brand, model, notes or reference number. |
| status | string | |
| sort_by | string | |
| category | string | e.g. electronics, watches, clothing |
| include_archived | boolean | Include archived and no-longer-owned items. |
| include_sensitive | boolean | API keys only: include stored identifiers. Ignored for connectors without pii:read. |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "1-200, default 50"
},
"offset": {
"type": "number"
},
"search": {
"type": "string",
"description": "Match name, brand, model, notes or reference number."
},
"status": {
"enum": [
"wishlist",
"ordered",
"owned",
"listed_for_sale",
"sold",
"returned",
"lost",
"disposed",
"donated",
"archived"
],
"type": "string"
},
"sort_by": {
"enum": [
"created_at",
"name",
"value"
],
"type": "string"
},
"category": {
"type": "string",
"description": "e.g. electronics, watches, clothing"
},
"include_archived": {
"type": "boolean",
"description": "Include archived and no-longer-owned items."
},
"include_sensitive": {
"type": "boolean",
"description": "API keys only: include stored identifiers. Ignored for connectors without pii:read."
}
},
"additionalProperties": false
}One owned Inventory item in full: specs and spec_template, state with state_freshness (current, recent or stale for each key; check with the user before relying on stale state), capability_summary (one line to plan from, e.g. "Can my computer run this?"), valuations, linked people and photos. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| inventory_id* | string | The item id from add_inventory_item, get_inventory or search_inventory. |
{
"type": "object",
"required": [
"inventory_id"
],
"properties": {
"inventory_id": {
"type": "string",
"description": "The item id from add_inventory_item, get_inventory or search_inventory."
}
},
"additionalProperties": false
}Chronological valuation history for one owned Inventory item. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| inventory_id* | string | The item id from add_inventory_item, get_inventory or search_inventory. |
{
"type": "object",
"required": [
"inventory_id"
],
"properties": {
"inventory_id": {
"type": "string",
"description": "The item id from add_inventory_item, get_inventory or search_inventory."
}
},
"additionalProperties": false
}Get a snapshot of the authenticated user's current life context (identity, today/upcoming events, pulse, trackers, plus a question-aware facts slice with trace). Relationships and memories are included by default; pass include_*=false to omit. social_edges is capped at the highest-confidence 40 — check social_edges_truncated / social_edges_total. Location is opt-in. Requires an authenticated Dayze account via OAuth; scoped API keys are also supported for direct clients. ($0.15; API key required)
| Argument | Type | Description |
|---|---|---|
| q | string | Alias for query. |
| at | string | ISO date-time to answer as of (default now), e.g. 2026-09-26T09:00:00+08:00. |
| query | string | Optional question. Drives the question-aware facts slice (family, names, dates, merchants) returned in facts/trace. |
| timezone | string | IANA time zone for today (default: where the user is now, else their home zone). |
| include_money | boolean | Include money facts in the question-aware facts slice (opt-in; the grant must allow financial details). |
| include_location | boolean | Include city/country label; never returns a precise address |
| include_memories | boolean |
Explicit private life-graph export: favorites/VIP plus people with edges or recent event tags. Pass full=true for a larger capped list. Optional event–people links. Requires OAuth or a supported scoped credential. ($0.25; API key required)
| Argument | Type | Description |
|---|---|---|
| full | boolean | Include additional people by last interaction, up to max_people |
| max_people | number | |
| event_links_limit | number | |
| include_event_links | boolean |
{
"type": "object",
"properties": {
"full": {
"type": "boolean",
"default": false,
"description": "Include additional people by last interaction, up to max_people"
},
"max_people": {
"type": "number",
"default": 80
},
"event_links_limit": {
"type": "number",
"default": 25
},
"include_event_links": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}Likely current or at-time place with confidence and provenance. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| at | string | ISO timestamp |
{
"type": "object",
"properties": {
"at": {
"type": "string",
"description": "ISO timestamp"
}
},
"additionalProperties": false
}Normalized visit history (venue-level by default). Merges GPS location_visits + place_visits (MCP/Uber digs). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | |
| city | string | |
| from | string | |
| place | string | |
| country | string | |
| precision | string |
{
"type": "object",
"properties": {
"to": {
"type": "string"
},
"city": {
"type": "string"
},
"from": {
"type": "string"
},
"place": {
"type": "string"
},
"country": {
"type": "string"
},
"precision": {
"enum": [
"point",
"venue",
"neighborhood",
"city",
"country"
],
"type": "string"
}
},
"additionalProperties": false
}Authenticated user memories from Dayze Agent. Pass query for semantic/keyword retrieval. Prefer search for event-first trip and calendar titles. Requires OAuth or a supported scoped credential. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| q | string | Alias for query. |
| focus | string | Ranks memories toward this focus. next_actions (or current, now) returns only up to 4 next-action memories. |
| limit | number | Max rows 1–50, default 20 |
| query | string | Semantic focus (optional) |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Alias for query."
},
"focus": {
"type": "string",
"description": "Ranks memories toward this focus. next_actions (or current, now) returns only up to 4 next-action memories."
},
"limit": {
"type": "number",
"description": "Max rows 1–50, default 20"
},
"query": {
"type": "string",
"description": "Semantic focus (optional)"
}
},
"additionalProperties": false
}List owned Moments by date, title, type, tag, person or place. Stable moment_id and inspect_url for each. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | YYYY-MM-DD inclusive |
| tag | string | |
| from | string | YYYY-MM-DD inclusive |
| limit | integer | |
| place | string | |
| title | string | |
| offset | integer | |
| person_id | string | |
| moment_type | string |
{
"type": "object",
"required": [],
"properties": {
"to": {
"type": "string",
"description": "YYYY-MM-DD inclusive"
},
"tag": {
"type": "string"
},
"from": {
"type": "string",
"description": "YYYY-MM-DD inclusive"
},
"limit": {
"type": "integer"
},
"place": {
"type": "string"
},
"title": {
"type": "string"
},
"offset": {
"type": "integer"
},
"person_id": {
"type": "string"
},
"moment_type": {
"type": "string"
}
},
"additionalProperties": false
}Same as get_person_transactions: authenticated user ↔ one contact via individual expense rows. Requires context.read and financial_details:read. Prefer get_person_transactions; this alias exists for agent discoverability. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | Inclusive YYYY-MM-DD filter |
| from | string | Inclusive YYYY-MM-DD filter |
| name | string | Surface name if person_id unknown |
| limit | number | Max rows 1–200, default 50 |
| person_id | string | CRM people.id |
{
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Inclusive YYYY-MM-DD filter"
},
"from": {
"type": "string",
"description": "Inclusive YYYY-MM-DD filter"
},
"name": {
"type": "string",
"description": "Surface name if person_id unknown"
},
"limit": {
"type": "number",
"description": "Max rows 1–200, default 50"
},
"person_id": {
"type": "string",
"description": "CRM people.id"
}
},
"additionalProperties": false
}Read evidence-backed travel legs with their origin, destination, timing, mode, provider, distance, and linked expense. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | |
| from | string | |
| limit | number |
{
"type": "object",
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"limit": {
"type": "number"
}
},
"additionalProperties": false
}Pending Replies (Inbox): the replies the user owes ('who do I owe a reply?'), newest first, or one by reply_id. status: unsent (default; pending + snoozed), sent, dismissed, all. Filter by person_name or person_id. Each reply has reply_id, person_name, person_id (null when unlinked), draft, summary, channel, category, source ids, status, state (unsent | sent | dismissed) and due (owed now; false while snoozed until snooze_until). Read-only. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| limit | number | 1-200, default 50. |
| status | string | |
| reply_id | string | Read one reply (ignores the filters). |
| person_id | string | |
| person_name | string |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "1-200, default 50."
},
"status": {
"enum": [
"unsent",
"sent",
"dismissed",
"all"
],
"type": "string"
},
"reply_id": {
"type": "string",
"description": "Read one reply (ignores the filters)."
},
"person_id": {
"type": "string"
},
"person_name": {
"type": "string"
}
},
"additionalProperties": false
}List or search the authenticated user's Dayze Contacts (private CRM; table people). query matches literal substrings of name, slug, email, occupation or context tags (no fuzzy fallback). context_tags requires all exact tags; occupation requires a substring. These filters combine with query and search the full owned contact set before pagination. Set wealth_category=reviewed for only explicitly owner-reviewed wealth-category contacts: returns id and name only, even with include_notes=true. That mode searches names only, uses offset rather than cursor, and cannot combine with occupation or context_tags. Without it, each contact includes avatar_url, photo_count, and has_photos; use get_person_photos(person_id) for the full gallery. With financial_details:read, net_worth_assessment includes category, scope, estimated range (when supported), confidence, methodology, caveat, dated source URLs, and review date. Context-only and insufficient-evidence assessments carry no personal number. birthday_precision says which parts of birthday are real: month_day means the year is unknown (stored 1900, or 1904 for Feb 29), year means only the year. Notes omitted by default (has_notes flag); pass include_notes=true for progressive fetch (credential/secret spans are redacted server-side). Supports limit (default 100, max 500) and offset; returns total and truncated. Distinct from public notable People at /people. Advertised name get_people is stable; tools/call also accepts get_contacts / list_contacts. Requires OAuth or a supported scoped credential. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| limit | number | Page size (default 100, max 500) |
| lists | array | Only contacts on any of these contact lists (ids or slugs from list_contact_lists), by name; page with offset. Cannot combine with query, occupation, context_tags, wealth_category or cursor. |
Fetch start_people_cleanup result by cleanup_id. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| cleanup_id* | string |
{
"type": "object",
"required": [
"cleanup_id"
],
"properties": {
"cleanup_id": {
"type": "string"
}
},
"additionalProperties": false
}Alias of get_person_connections — list graph edges for one CRM person. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| person_id* | string |
{
"type": "object",
"required": [
"person_id"
],
"properties": {
"person_id": {
"type": "string"
}
},
"additionalProperties": false
}List canonical aliases (nicknames) for a CRM person. Pass person_id or name (resolved via aliases). Requires OAuth or a supported scoped credential. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| name | string | Surface name if person_id unknown |
| person_id | string | CRM people.id |
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Surface name if person_id unknown"
},
"person_id": {
"type": "string",
"description": "CRM people.id"
}
},
"additionalProperties": false
}List graph edges for one CRM person. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| person_id* | string |
{
"type": "object",
"required": [
"person_id"
],
"properties": {
"person_id": {
"type": "string"
}
},
"additionalProperties": false
}Relationship timeline for one CRM person: interactions rows (message/call/meeting/note + extended kinds like visit/gift/stayed_over encoded in summary) plus co-tagged calendar events. Prefer this over dumping people.notes for “when did I last see X?”. Pass person_id or name. Records carry inspect_url (their Dayze page): cite with it, never build a link from an id; a record without one has no page (inspect_note says which). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | Inclusive YYYY-MM-DD filter |
| from | string | Inclusive YYYY-MM-DD filter |
| kind | string | Optional filter: meeting, visit, gift, stayed_over, met, … |
| name | string | |
| limit | number | Max rows 1–100, default 40 |
| person_id | string |
{
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Inclusive YYYY-MM-DD filter"
},
"from": {
"type": "string",
"description": "Inclusive YYYY-MM-DD filter"
},
"kind": {
"type": "string",
"description": "Optional filter: meeting, visit, gift, stayed_over, met, …"
},
"name": {
"type": "string"
},
"limit": {
"type": "number",
"description": "Max rows 1–100, default 40"
},
"person_id": {
"type": "string"
}
},
"additionalProperties": false
}Subgraph around one user-owned person_id — profile (avatar_url, photo_count, has_photos) plus declared connections. Use get_person_photos for the full gallery. Notes omitted unless include_notes=true (redacted). Requires OAuth or a supported scoped credential. ($0.15; API key required)
| Argument | Type | Description |
|---|---|---|
| person_id* | string | UUID |
| include_notes | boolean | When true, include center.notes (server-redacted). Default false. |
{
"type": "object",
"required": [
"person_id"
],
"properties": {
"person_id": {
"type": "string",
"description": "UUID"
},
"include_notes": {
"type": "boolean",
"description": "When true, include center.notes (server-redacted). Default false."
}
},
"additionalProperties": false
}Read a contact avatar and gallery as inline MCP images with per-asset render status. Avatar comes first. Use offset to page through photos (up to six per call); never paste raw image URLs into chat. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| person_id* | string |
{
"type": "object",
"required": [
"person_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 6,
"minimum": 1
},
"offset": {
"type": "integer",
"minimum": 0
},
"person_id": {
"type": "string"
}
},
"additionalProperties": false
}Me↔contact money ledger from individual expenses (paid_to_person_id / income_from_person_id). Requires context.read and financial_details:read. Pass person_id or name. Returns entries + per-currency totals. Reuses existing expenses — no parallel ledger table. Records carry inspect_url (their Dayze page): cite with it, never build a link from an id; a record without one has no page (inspect_note says which). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | Inclusive YYYY-MM-DD filter |
| from | string | Inclusive YYYY-MM-DD filter |
| name | string | Surface name if person_id unknown |
| limit | number | Max rows 1–200, default 50 |
| person_id | string | CRM people.id |
{
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Inclusive YYYY-MM-DD filter"
},
"from": {
"type": "string",
"description": "Inclusive YYYY-MM-DD filter"
},
"name": {
"type": "string",
"description": "Surface name if person_id unknown"
},
"limit": {
"type": "number",
"description": "Max rows 1–200, default 50"
},
"person_id": {
"type": "string",
"description": "CRM people.id"
}
},
"additionalProperties": false
}Single photo metadata + secure URL. Returns inline MCP image attachment when available. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| photo_id* | string |
{
"type": "object",
"required": [
"photo_id"
],
"properties": {
"photo_id": {
"type": "string"
}
},
"additionalProperties": false
}Assets linked to an event. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| event_id* | string |
{
"type": "object",
"required": [
"event_id"
],
"properties": {
"event_id": {
"type": "string"
}
},
"additionalProperties": false
}Assets linked to a canonical place. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| place_id* | string |
{
"type": "object",
"required": [
"place_id"
],
"properties": {
"place_id": {
"type": "string"
}
},
"additionalProperties": false
}Fetch one saved place card (business_contacts) by place_id — address, opening hours, affordability, notes. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| id | string | |
| place_id | string | |
| business_contact_id | string |
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"place_id": {
"type": "string"
},
"business_contact_id": {
"type": "string"
}
},
"additionalProperties": false
}Count confirmed outings at a venue. Resolves aliases first; typed PlaceVisits are primary, and past non-todo events/GPS evidence for the canonical place are reconciled by day. count excludes plans, todos, and separately labelled reconstructed_candidates. Returns visit dates and evidence refs. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | |
| from | string | |
| place* | string | |
| place_id | string | |
| person_ids | array |
{
"type": "object",
"required": [
"place"
],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"place": {
"type": "string"
},
"place_id": {
"type": "string"
},
"person_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}Known venues: visit-graph `places` plus saved place cards (`saved_places` from business_contacts) with address, opening_hours, and affordability ($/$$/$$$). `query` filters both lists by name. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| tag | string | |
| area | string | |
| city | string | |
| near | string | Filter saved cards by area/tag/notes (e.g. Madeira). |
| limit | number | |
| query | string | Name contains, case-insensitive (e.g. "QA Map Probe Tokyo"). |
| country | string | |
| affordability | string | $ | $$ | $$$ |
{
"type": "object",
"properties": {
"tag": {
"type": "string"
},
"area": {
"type": "string"
},
"city": {
"type": "string"
},
"near": {
"type": "string",
"description": "Filter saved cards by area/tag/notes (e.g. Madeira)."
},
"limit": {
"type": "number"
},
"query": {
"type": "string",
"description": "Name contains, case-insensitive (e.g. \"QA Map Probe Tokyo\")."
},
"country": {
"type": "string"
},
"affordability": {
"type": "string",
"description": "$ | $$ | $$$"
}
},
"additionalProperties": false
}Home / residence history separate from trips: trips with metadata.kind=residence (from log_travel) plus optional life_eras. Use for Boylston / Madeira / current home cards. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | |
| from | string | |
| limit | number | |
| include_eras | boolean | Include life_eras rows (default true) |
{
"type": "object",
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"limit": {
"type": "number"
},
"include_eras": {
"type": "boolean",
"description": "Include life_eras rows (default true)"
}
},
"additionalProperties": false
}Sleep: list typed sleep/nap records with duration_minutes. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | |
| from | string | |
| limit | number |
{
"type": "object",
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"limit": {
"type": "number"
}
},
"additionalProperties": false
}Sleep: day/week/month totals and averages. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| range | string |
{
"type": "object",
"properties": {
"range": {
"enum": [
"day",
"week",
"month"
],
"type": "string"
}
},
"additionalProperties": false
}The user's days in one read: calendar events, Moments (lived stories) and Food Diary entries for a civil date range in the account timezone (max 92 days; default today). A food entry's calendar mirror is listed once, under food. Text the connection may not see is redacted as in get_events. Each record keeps its id and inspect_url where it has a page. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| at | string | Optional ISO instant to read "today" at (defaults to now). |
| to | string | Last civil day, YYYY-MM-DD, inclusive. |
| date | string | Alias for from (one day). |
| from | string | First civil day, YYYY-MM-DD, in the account timezone. Alone = that one day. Default: today. |
| timezone | string | 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. |
{
"type": "object",
"required": [],
"properties": {
"at": {
"type": "string",
"description": "Optional ISO instant to read \"today\" at (defaults to now)."
},
"to": {
"type": "string",
"description": "Last civil day, YYYY-MM-DD, inclusive."
},
"date": {
"type": "string",
"description": "Alias for from (one day)."
},
"from": {
"type": "string",
"description": "First civil day, YYYY-MM-DD, in the account timezone. Alone = that one day. Default: today."
},
"timezone": {
"type": "string",
"description": "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."
}
},
"additionalProperties": false
}Today 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)
| Argument | Type | Description |
|---|---|---|
| at | string | Optional ISO instant to read "today" at (defaults to now). |
| currency | string | Optional 3-letter display currency for the money totals (default: the account's most used). |
| timezone | string | 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. |
{
"type": "object",
"required": [],
"properties": {
"at": {
"type": "string",
"description": "Optional ISO instant to read \"today\" at (defaults to now)."
},
"currency": {
"type": "string",
"description": "Optional 3-letter display currency for the money totals (default: the account's most used)."
},
"timezone": {
"type": "string",
"description": "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."
}
},
"additionalProperties": false
}Authenticated user live trackers only; expired countdowns and inactive streaks are omitted. Sobriety/streak trackers remain visible at day 0 after a reset. Merges event-backed trackers with the trackers table when present. current_value is read from the tracker's events: days for sobriety/streak, days left for a countdown, the total for a counter (value_unit), with last_event_date. Returns up to `limit` trackers (default 50, max 200; get_context_pack's active_trackers keeps 6); total and truncated say whether more exist. Requires OAuth or a supported scoped credential. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| limit | number | Max trackers 1–200, default 50 |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"maximum": 200,
"minimum": 1,
"description": "Max trackers 1–200, default 50"
}
},
"additionalProperties": false
}List individual expense/income/transfer rows (includes tags, payment_method). Requires context.read and financial_details:read. Filter with tag=project:… or project=… ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | |
| tag | string | Exact tag, e.g. project:max-soko-poker-venture or rail:zelle |
| from | string | |
| type | string | |
| limit | number | Page size 1-500, default 100. |
| cursor | string | Continue the same immutable one-hour snapshot; other filters remain frozen. |
| offset | number | Skip this many rows of a new snapshot (a cursor carries its own). |
| project | string | Project label or slug → project:{slug} |
| include_archived | boolean |
Completed/confirmed travel only. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | |
| from | string |
{
"type": "object",
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
}
},
"additionalProperties": false
}Single trip with linked places and people. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| trip_id* | string |
{
"type": "object",
"required": [
"trip_id"
],
"properties": {
"trip_id": {
"type": "string"
}
},
"additionalProperties": false
}User trips with status filter (planned/completed/etc.). Residences also appear here with metadata.kind=residence — prefer get_residences for home history. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | |
| from | string | |
| limit | number | |
| cursor | string | Continue the same immutable one-hour snapshot; other filters remain frozen. |
| status | string | |
| include_archived | boolean |
{
"type": "object",
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"limit": {
"type": "number"
},
"cursor": {
"type": "string",
"description": "Continue the same immutable one-hour snapshot; other filters remain frozen."
},
"status": {
"type": "string"
},
"include_archived": {
"type": "boolean"
}
},
"additionalProperties": false
}Preview or import completed Lyft and Uber receipts as deduplicated origin-to-destination movements plus linked expenses. dry_run returns the exact proposed records without writing. Requires mail.read on an API key or non-ChatGPT OAuth connection. ChatGPT profiles do not grant mail.read or list this tool. ($0.15; API key required)
| Argument | Type | Description |
|---|---|---|
| string | ||
| query | string | |
| account | string | |
| dry_run | boolean | |
| request_id | string | Client idempotency key (retries return original result). |
| max_results | number | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"properties": {
"email": {
"type": "string"
},
"query": {
"type": "string"
},
"account": {
"type": "string"
},
"dry_run": {
"type": "boolean"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"max_results": {
"type": "number"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Search connected Gmail for Uber trip receipts and write log_place_visit rows with sources gmail:uber-{gmail_id} (idempotent). Optional dry_run, max_results, query, account. Requires mail.read on an API key or non-ChatGPT OAuth connection. ChatGPT profiles do not grant mail.read or list this tool. ($0.15; API key required)
| Argument | Type | Description |
|---|---|---|
| string | ||
| query | string | Override Gmail search (default from:uber.com receipt/trip) |
| account | string | |
| dry_run | boolean | |
| request_id | string | Client idempotency key (retries return original result). |
| max_results | number | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"properties": {
"email": {
"type": "string"
},
"query": {
"type": "string",
"description": "Override Gmail search (default from:uber.com receipt/trip)"
},
"account": {
"type": "string"
},
"dry_run": {
"type": "boolean"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"max_results": {
"type": "number"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Search connected Gmail for Venmo receipts and write log_transaction rows with external_id=venmo-gmail-{gmail_id} (idempotent). Optional dry_run, max_results, query, mirror_event, account. Prefer this over calendar-only Money · digs. Requires mail.read on an API key or non-ChatGPT OAuth connection. ChatGPT profiles do not grant mail.read or list this tool. ($0.15; API key required)
| Argument | Type | Description |
|---|---|---|
| string | Alias for account | |
| query | string | Override Gmail search (default from:venmo.com paid/payment) |
| account | string | Mailbox email or connection id |
| dry_run | boolean | |
| request_id | string | Client idempotency key (retries return original result). |
| max_results | number | |
| mirror_event | boolean | Also create Money · calendar annotations |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Alias for account"
},
"query": {
"type": "string",
"description": "Override Gmail search (default from:venmo.com paid/payment)"
},
"account": {
"type": "string",
"description": "Mailbox email or connection id"
},
"dry_run": {
"type": "boolean"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"max_results": {
"type": "number"
},
"mirror_event": {
"type": "boolean",
"description": "Also create Money · calendar annotations"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Link Trip→Stay→Place / Event→Person (graph, not prose). link_type accepts documented aliases (e.g. participant → event_person); unknown values error instead of silently becoming "other". Pass status=confirmed|rejected to record a human decision on an existing (often inferred) edge. status=confirmed on a link that does not exist yet creates it, as a call without status does (explicit, confidence 1). status=rejected on a link that does not exist errors and saves nothing: there is nothing to reject. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| notes | string | |
| to_id* | string | |
| source | string | Provenance tag, e.g. manual, inferred:name_match:title. |
| status | string | confirmed: confirm an existing edge (usually an inferred one: +confirmed, confidence 1), or create the edge if it does not exist yet, as a call without status does. rejected: tombstone an existing edge (+rejected, confidence 0). A rejected edge is not a relationship: the event's people, timelines, get_interactions and every other read leave it out. It is kept so automated writers never recreate it; linking the same pair again without status replaces it. Errors and saves nothing when the edge does not exist. |
| from_id* | string | |
| to_type* | string | |
| from_type |
Link one owned contact to one owned Inventory item as its provenance: inherited_from, gifted_by, purchased_from, co_owned_with, borrowed_from or loaned_to. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| notes | string | |
| person_id* | string | Contact id (from get_people or resolve_person). |
| request_id | string | Client idempotency key (retries return original result). |
| inventory_id* | string | The item id from add_inventory_item, get_inventory or search_inventory. |
| relationship* | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"inventory_id",
"person_id",
"relationship"
],
"properties": {
"notes": {
"type": "string"
},
"person_id": {
"type": "string",
"description": "Contact id (from get_people or resolve_person)."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"inventory_id": {
"type": "string",
"description": "The item id from add_inventory_item, get_inventory or search_inventory."
},
"relationship": {
"enum": [
"inherited_from",
"gifted_by",
"purchased_from",
"co_owned_with",
"borrowed_from",
"loaned_to"
],
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}NON-DESTRUCTIVE: create/update a person_connections edge between two distinct people (friends/family/knows/…). Both contacts remain. Do not use for duplicate cleanup — use merge_people. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| notes | string | |
| source | string | |
| direction | string | |
| person_id* | string | |
| confidence | number | |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
| other_person_id* | string | |
| relationship_type | string |
{
"type": "object",
"required": [
"person_id",
"other_person_id"
],
"properties": {
"notes": {
"type": "string"
},
"source": {
"type": "string"
},
"direction": {
"type": "string"
},
"person_id": {
"type": "string"
},
"confidence": {
"type": "number"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"other_person_id": {
"type": "string"
},
"relationship_type": {
"type": "string"
}
},
"additionalProperties": false
}Ranked clarification queue: only person-typed mentions + duplicate CRM people. Non-person junk (places, orgs, media, command fragments) is auto-dismissed. Existing contacts auto-link. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| kind | string | Optional: entity_mention | duplicate_people |
| limit | number | Max rows 1–50, default 15 |
| auto_cleanup | boolean | Auto-dismiss non-person / auto-link existing (default true) |
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Optional: entity_mention | duplicate_people"
},
"limit": {
"type": "number",
"description": "Max rows 1–50, default 15"
},
"auto_cleanup": {
"type": "boolean",
"description": "Auto-dismiss non-person / auto-link existing (default true)"
}
},
"additionalProperties": false
}List the owner's contact lists (the lists on Contacts), by name: id, name, slug, member_count, created_at. auto_synced marks Family, which follows each contact's relationship. Filter contacts by list with get_people(lists). ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| include_counts | boolean | Include member_count (default true). |
{
"type": "object",
"properties": {
"include_counts": {
"type": "boolean",
"description": "Include member_count (default true)."
}
},
"additionalProperties": false
}List the owner’s recent event classification and event-person correction ledger, including undone entries. ($0.10; API key required)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List connected Gmail mailboxes for the authenticated user (id, email, is_default). Use account on search_gmail / read_gmail_* / import_*_gmail to pick a mailbox. Connect another inbox at /integrations (multi-mailbox after migration). Requires mail.read on an API key or non-ChatGPT OAuth connection. ChatGPT profiles do not grant mail.read or list this tool. Share tokens cannot call. ($0.05; API key required)
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Save a day's check-in for one condition with the same explicit subject_type/person_id. Self check-ins show on the user's Day Card; another person's do not. severity 0-10, note, treatment_done; logged_on defaults today. One per condition/day. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| note | string | |
| severity | integer | 0 (none) to 10 (worst). |
| logged_on | string | YYYY-MM-DD; default today in the user's time zone. |
| person_id | string | Owned contact id; required for person. |
| request_id | string | Client idempotency key (retries return original result). |
| condition_id* | string | From get_conditions or create_condition. |
| subject_type* | string | self, or person with person_id. |
| treatment_done | string | What they did for it that day. |
| idempotency_key | string | Alias for request_id. |
CREATES one entry from what the user said: type food/meal/snack/drink/kopi/coffee → Food Diary (with its Finance row when amount is given), expense → Finance, moment → a private Moment. Uses the same duplicate check as Dayze chat: the identical entry sent again within about 2 minutes is not saved twice and the reply says "Already logged that a moment ago". Shows in Dayze with "Added by <this app>" and can be undone from the record. Returns the saved record id (food_id, expense_id or moment_id). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| text* | string | What the user had, bought or did, in their words (max 500). For food the item ("kopi peng"); for an expense what it was for. |
| type* | string | What kind of entry. |
| when | string | Optional ISO 8601 instant with offset when it happened. Leave out for now. |
| place | string | Optional place or merchant name. |
| amount | number | Price paid, a positive number. Required for type expense. |
| category | string | Optional Finance category, type expense only. |
| currency | string | 3-letter currency of amount (e.g. SGD). |
| timezone | string |
MUTATES the calendar (non-food events, tasks, sleep). Replies owed ('what to reply to X') go to create_pending_reply. Woke at X: end_time. Requires title plus event_date or date (YYYY-MM-DD, YYYY-MM, or YYYY). A task with no deadline: ask for a date, never fill in today. Soft dates preserve date_precision. A story or anecdote about something that already happened is a moment: use log_moment (with event_id when it is about an event here), not a second event. Optional: event_time (alias time), end_date, end_time, location, description (alias notes), category, visibility, timezone, reminder fields, sharing/people, scoreboard (structured operating status; keep description for notes), and idempotency_key. Sleep with only a wake time ('I woke at 11:15'): category sleep, event_date the day they woke, end_time 11:15 and no event_time. Don't invent a bedtime; add it later with update_event event_time (a bedtime the night before also sets event_date to that night and end_date to the wake day). Timed events default to the profile push-reminder timing; all-day events and starts already in the past stay off. Log / past-tense entries should pass reminder_enabled=false; reminder_minutes_before sets the lead time. Prefer log_travel for trips/residences. Unknown people do not fail the write. Public events return share_url. Requires API key or OAuth with context scope; share tokens cannot write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| city | string | Structured city (composed into location if location omitted) |
| date | string | Alias for event_date. |
| time | string | Alias for event_time. |
| with | array | Alias for people. |
| notes | string |
Create an outgoing expense only. For money received (Venmo/Cash App/PayPal/Zelle) use log_transaction with direction=from and type=income. Lending a contact cash: category "IOU lend" + person_id (one call creates the IOU they owe and shows the money out once). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| date | string | |
| tags | array | Optional tags. Prefer project: / ext: / rail: grammar. |
| notes | string | Free text about the payment. Alias: description. |
| amount* | number | |
| source | string | Payment rail or app: venmo, zelle, cashapp, card, cash, … Alias: payment_method. |
| project | string | Venture/project label → stored as project:{slug} tag (e.g. Max Soko poker venture) |
| category | string | "IOU repayment" = paying a contact back; "IOU lend" = lending a contact cash (both need person_id). |
| currency | string | |
| iou_type | string | loan (default) or invoice. Invoice = unpaid receivable: no Finance outflow on create; payment is income "Invoice payment". Use for invoice/receivable phrasings; "I lent…" → loan. |
MUTATES the authenticated user favorite tracks list at /music. Use when they favorite or save a song — do not store this as a chat memory or in music_preferences. Example: “Henry Mancini - Piano And Strings (1995 Remastered)” → log_favorite_song({ track: "Henry Mancini - Piano And Strings (1995 Remastered)" }) or title + artist. Optional year_note, source_url, and person_id from get_people to link the track to one owned contact. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| url | string | Alias for source_url |
| title | string | Track title (required unless track blob parses) |
| track | string | Optional "Artist - Title (year remaster)" blob |
| artist | string | Artist name (required unless track blob parses) |
| person_id | string | Optional owned contact id from get_people; the track appears on that contact profile and shared history |
| year_note | string | Optional year or remaster note |
| request_id | string | Client idempotency key (retries return original result). |
| source_url | string | Optional https link |
MUTATES the authenticated user Food Diary and calendar. Use when they ate or drank — do not store this as a chat memory. Supports dish_items for multiple named dishes with optional price and rating. Example: “I had Mee Pok for late lunch with my parents” → log_food({ what: "Mee Pok", kind: "meal", meal_period: "late lunch", with: ["my parents"] }). Optional: calories (user-stated kilocalories), place/merchant, amount, consumed_at (ISO). Explicit calories override the automatic heuristic. Resolves with/Mum/Dad via person aliases; unknown names do not fail the food write. Tags companions on the mirrored event. Rebuilds life_state. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| kind | string | |
| what* | string | What they ate or drank (required). Example: Mee Pok |
| with | array | Companion names, aliases, ids, or group tokens. "my parents" / Mum / Dad resolve via aliases; "family" expands to CRM rows with family relationship labels |
| notes | string | |
| place | string | Venue or location |
| amount | number | Price if mentioned |
| paid_by | string | Who paid. A person's name or alias for a third party; "self" / "me" = the user paid (recorded in Finance); "unknown" = payer not known. Not a payment method: use payment_method |
Record money received (Stripe, refunds, payroll, Venmo). log_transaction with type income and direction from already set (pass neither). Use external_id for Stripe/Gmail idempotency. A contact paying back an IOU: category "IOU repayment" + person_id (lowers the IOU, shows the money once). A contact lending the user cash: category "IOU lend" + person_id (creates the IOU the user owes, shows the money once). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| date | string | |
| tags | array | Optional tags. Prefer project: / ext: / rail: grammar. |
| notes | string | Free text about the payment. Alias: description. |
| amount* | number | |
| source | string | |
| project | string | Venture/project label → stored as project:{slug} tag (e.g. Max Soko poker venture) |
| category | string | e.g. Salary, Gift, Refund. "IOU repayment" and "IOU lend" need person_id. |
| currency | string | |
| iou_type | string | loan (default) or invoice. Invoice = unpaid receivable: no Finance outflow on create; payment is income "Invoice payment". Use for invoice/receivable phrasings; "I lent…" → loan. |
Contacts: log that the user was in touch with a contact ('I replied to Vadim', 'called Mum'): kind message, call, meeting, note, check_in or thought_of. Private to the owner. person_id (an owned contact) or person_name (linked only on one resolve_person match; otherwise nothing is logged and the candidates come back). With reply_id it also marks that Pending Reply sent: this interaction is the reply's one write-back (a later resolve adds no second). summary: one line in your own words, never email text or a subject. occurred_at: when it happened (ISO), default now; not in the future. Never sends anything. Requires API key or OAuth with context.write. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| kind | string | Default message. |
| summary | string | One line (max 280) in your own words. Never the email body, subject or sender. |
| reply_id | string | A Pending Reply (get_pending_replies) this closes as sent. |
| person_id | string | An owned contact id. |
| request_id | string | Client idempotency key (retries return original result). |
| occurred_at | string | When it happened (ISO date-time). Default now. |
| person_name | string | The contact as the user said it ("Vadim"); linked only on one match. |
Save a past story or memory as a private moment. Plans go to log_event; a touchpoint with a contact to log_interaction. Requires title, and moment_date (YYYY-MM-DD, YYYY-MM or YYYY; alias date) unless event_id is given. With event_id (an owned event the story is about) it creates a NEW moment linked to that event and takes the event's date and location when you pass none; the event itself is never changed, converted or deleted, and one event can have many moments. Don't also save the story as an event. Optional: description (the longer story), moment_date_precision (exact, month, year, circa), end_date, moment_type (default memory), location_name (only a place the user said), person_ids (owned contacts; any other id saves nothing), people_names (tag saved contacts only, never created), cover_image_url / media_urls (https links), tags. Always private: there is no visibility argument; the owner shares a moment in Dayze. Fix it later with update_moment. Requires API key or OAuth with context.write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| date | string | Alias for moment_date. |
| tags | array | Optional short tags (max 20, 40 characters each). |
| title* | string | The story in a few words (max 200), e.g. "Mia called the moon a banana". |
| end_date | string | Optional last day YYYY-MM-DD, for a moment that spans days. |
| event_id | string | A calendar event this story is about (owned). Links the new moment to it; the event is not changed. |
| location |
Log one provenance-backed movement segment. Origin, destination, timestamps, source, and external_id are required for a deduplicated route history. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| mode* | string | |
| origin* | string | |
| source* | string | |
| metadata | object | |
| provider | string | |
| arrived_at* | string | |
| confidence | number | |
| expense_id | string | |
| request_id | string | Client idempotency key (retries return original result). |
| departed_at* | string | |
| destination |
MUTATES place_visits for map/history digs (Uber dropoff, address evidence). Required: place (or place_id) + arrived_at/date. arrived_at: a clock time with offset when the user gave a time or part of day (afternoon → 15:00 local); YYYY-MM-DD when only the day is known — the visit is then stored with no clock time and the receipt says "time not specified". arrival_time_precision: approximate when the clock time reads a part of day (evening → 19:00), so readers show "~19:00"; exact (default) only for a time the user gave. Optional: departed_at, source (a provenance tag: uber|mcp|manual|import, not a note), evidence_expense_id (idempotent), city/country/address. Add-only: a repeat on the same day returns the stored visit (duplicate: true, retained, mismatch) and never changes it. Prefer this over stuffing streets only into expenses. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| city | string | |
| date | string | Alias for arrived_at (YYYY-MM-DD: the day only, time not specified) |
| name | string | Alias for place |
| place | string | |
| source | string | Provenance tag (uber, mcp, manual, import, gmail:uber-<id>), not a note. |
| address | string | |
| country | string | |
| place_id |
Sleep: log overnight or nap. Cross-midnight OK (e.g. 14:00→03:00 = 13h / 780m). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| notes | string | |
| source | string | |
| quality | number | |
| ended_at* | string | ISO end |
| timezone | string | |
| request_id | string | Client idempotency key (retries return original result). |
| sleep_type | string | |
| started_at* | string | ISO start |
| timezone_end | string | |
| timezone_start | string | |
| idempotency_key | string | Alias for request_id. |
Income/expense/transfer write. direction=from + type=income for Venmo/Stripe/refunds received. Positive amount; external_id dedupes imports. Optional project/tags. Zelle always USD. Optional mirror_event creates a calendar Money · annotation (ledger is still the source of truth for /money). IOU repayment ("Mark paid me back $200"): category "IOU repayment" + person_id — one call lowers the IOU and shows the money once (direction from = they paid the user, to = the user paid them). A cash loan ("I lent Mark $200"): category "IOU lend" + person_id — one call creates the IOU and shows the money once on that day (direction to = the user lent them, from = they lent the user); cash_moved: false for an owed share (IOU only). A plain income from a contact with an open IOU is refused unless not_iou_repayment: true; the same money as an already-recorded repayment or loan comes back as duplicate. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| date | string | |
| tags | array | Optional tags. Prefer project: / ext: / rail: grammar. |
| type | string | |
| notes | string | Free text about the payment. Alias: description. |
| amount* | number | |
| source | string | |
| project | string | Venture/project label → stored as project:{slug} tag (e.g. Max Soko poker venture) |
MUTATES trips (+ optional calendar travel event). Prefer this over free-text log_event for map/history. Required: city + start_date. Optional: country, end_date, kind (trip|residence|soft_pin), confidence (confirmed|likely|possible), evidence, title, mirror_event. Soft pins default to status=possible and stay off cities/map until confidence=confirmed. The calendar event is private. Zelle/Venmo money belongs in log_transaction — not here. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| city* | string | |
| date | string | Alias for start_date |
| kind | string | |
| title | string | |
| country | string | |
| end_date | string | |
| evidence | string | Source note (Gmail id, address, etc.) |
| confidence | string | |
| request_id | string | Client idempotency key (retries return original result). |
| start_date |
Preview first, 30-day undo. Retire exact duplicates while keeping the named canonical memory. Preview shows every retired id and distinct provenance; the receipt restores all rows for 30 days. Similar wording is refused. Reviewed and reversible: first call preview_destructive_change({ tool: "merge_memory", arguments: { canonical_memory_id, duplicate_memory_ids } }), which stores the exact change without applying it. After the user confirms, call merge_memory with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| idempotency_key | string | Alias for request_id. |
| canonical_memory_id | string | Surviving memory id, checked against the preview. |
| restore_window_acknowledged* | boolean | Must be true after reviewing the preview and its 30-day restore window. |
Preview first, 30-day undo. Preview with preview_destructive_change({tool:"merge_moments",arguments:{canonical_id,retired_ids}}). Conflicting story, date, place or event links stop the merge. Union people, tags and media. Reviewed and reversible: first call preview_destructive_change({ tool: "merge_moments", arguments: { canonical_id, retired_ids } }), which stores the exact change without applying it. After the user confirms, call merge_moments with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| retired_ids* | array | |
| canonical_id* | string | |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged* | boolean | Must be true after reviewing the preview and its 30-day restore window. |
Apply a reviewed durable preview atomically; undo_contact_change accepts restore_id for 30 days if unchanged. Fold duplicate CRM contact(s) into primary_person_id (same human, spelling variants). Prefer score_people_duplicates first. Not for “X knows Y” — use link_people for relationships. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| preview_id* | string | Durable preview_id returned by merge_people_preview; review the 30-day restore window before applying. |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
| primary_person_id* | string | |
| duplicate_person_ids* | array | |
| restore_window_acknowledged* | boolean | Must be true — confirms the 30-day restore window was reviewed before apply. |
{
"type": "object",
"required": [
"primary_person_id",
"duplicate_person_ids",
"preview_id",
"restore_window_acknowledged"
],
"properties": {
"preview_id": {
"type": "string",
"description": "Durable preview_id returned by merge_people_preview; review the 30-day restore window before applying."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"primary_person_id": {
"type": "string"
},
"duplicate_person_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true — confirms the 30-day restore window was reviewed before apply."
}
},
"additionalProperties": false
}Save a durable restore snapshot without modifying contacts before merge_people. Returns resulting name/aliases, preserved counts, field conflicts, safe_to_merge. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| request_id | string | Client idempotency key (retries return original result). |
| field_choices | object | |
| idempotency_key | string | Alias for request_id. |
| primary_person_id* | string | |
| duplicate_person_ids* | array |
{
"type": "object",
"required": [
"primary_person_id",
"duplicate_person_ids"
],
"properties": {
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"field_choices": {
"type": "object",
"additionalProperties": true
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"primary_person_id": {
"type": "string"
},
"duplicate_person_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}Apply a normalize_people_preview by preview_id. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| preview_id* | string | |
| request_id* | string | |
| candidate_hash* | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"preview_id",
"candidate_hash",
"request_id"
],
"properties": {
"preview_id": {
"type": "string"
},
"request_id": {
"type": "string"
},
"candidate_hash": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Preview whitespace/phone/handle normalization changes (no title-case of stylized names). ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| rules | array | |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"properties": {
"rules": {
"type": "array",
"items": {
"type": "string"
}
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}DEFAULT for who is X: profile + life_in_days (age/day_number) + similar people + birthday peers. Timeline events include day_number. Prefer this over notable_profile. Example: albert-einstein. ($0.05)
| Argument | Type | Description |
|---|---|---|
| date | string | YYYY-MM-DD target date |
| slug* | string | Person slug, e.g. albert-einstein |
| peers | number | |
| similar | number |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD target date"
},
"slug": {
"type": "string",
"description": "Person slug, e.g. albert-einstein"
},
"peers": {
"type": "number",
"default": 12
},
"similar": {
"type": "number",
"default": 8
}
},
"additionalProperties": false
}S-tier guaranteed pack (score≥85, timeline≥8, image, embedding). Errors if below bar. Use when you need high-quality, complete notable context. Example slug: elon-musk. ($0.10)
| Argument | Type | Description |
|---|---|---|
| date | string | |
| slug* | string | Person slug, e.g. elon-musk |
| peers | number | |
| similar | number |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"date": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Person slug, e.g. elon-musk"
},
"peers": {
"type": "number",
"default": 20
},
"similar": {
"type": "number",
"default": 12
}
},
"additionalProperties": false
}Bio-only profile JSON by slug (no life-in-days, similar, or birthday peers). Prefer notable_pack for “who is X / age in days / peers”. Example: taylor-swift. ($0.02)
| Argument | Type | Description |
|---|---|---|
| slug* | string | Person slug, e.g. albert-einstein |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Person slug, e.g. albert-einstein"
}
},
"additionalProperties": false
}Search the public Dayze notable-people catalog by name, occupation, or slug. Use when you need to find a person before fetching a pack. Example slug: albert-einstein. ($0.01)
| Argument | Type | Description |
|---|---|---|
| q | string | Primary search query. |
| limit | number | Max results 1–20 |
| query | string | Alias for q. |
{
"type": "object",
"anyOf": [
{
"required": [
"q"
]
},
{
"required": [
"query"
]
}
],
"properties": {
"q": {
"type": "string",
"description": "Primary search query."
},
"limit": {
"type": "number",
"default": 8,
"description": "Max results 1–20"
},
"query": {
"type": "string",
"description": "Alias for q."
}
},
"additionalProperties": false
}Review a destructive change before it happens. Stores the exact rows delete_food, delete_place, delete_place_visit, archive_inventory_item, archive_asset, reset_tracker, unlink_people, remove_person_alias, convert_contact_entity, bulk_dismiss_clarifications, delete_memory, delete_moment, merge_moments, merge_memory, correct_memory_atom would delete, archive or overwrite (with their before-state and linked records) without changing anything, and returns preview_id, operations, expires_at (30 minutes) and restore_window_days (30). Show it to the user, then call the named tool with preview_id, restore_window_acknowledged: true and request_id. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| tool* | string | |
| arguments* | object | The arguments you would pass to that tool (e.g. { food_id }). |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"tool",
"arguments"
],
"properties": {
"tool": {
"enum": [
"delete_food",
"delete_place",
"delete_place_visit",
"archive_inventory_item",
"archive_asset",
"reset_tracker",
"unlink_people",
"remove_person_alias",
"convert_contact_entity",
"bulk_dismiss_clarifications",
"delete_memory",
"delete_moment",
"merge_moments",
"merge_memory",
"correct_memory_atom"
],
"type": "string"
},
"arguments": {
"type": "object",
"description": "The arguments you would pass to that tool (e.g. { food_id }).",
"additionalProperties": true
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Group exact Moment duplicates first, then possible near duplicates for human review. Never merges automatically. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| to* | string | YYYY-MM-DD inclusive |
| from* | string | YYYY-MM-DD inclusive |
{
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"description": "YYYY-MM-DD inclusive"
},
"from": {
"type": "string",
"description": "YYYY-MM-DD inclusive"
}
},
"additionalProperties": false
}Propose assertion create/correct without committing (flagged; off by default). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| value | object | |
| client_id | string | |
| people_id | string | |
| person_id | string | |
| predicate | string | |
| operations | array | |
| request_id | string | |
| source_text | string | |
| idempotency_key | string |
{
"type": "object",
"properties": {
"value": {
"type": "object",
"additionalProperties": true
},
"client_id": {
"type": "string"
},
"people_id": {
"type": "string"
},
"person_id": {
"type": "string"
},
"predicate": {
"type": "string"
},
"operations": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"request_id": {
"type": "string"
},
"source_text": {
"type": "string"
},
"idempotency_key": {
"type": "string"
}
},
"additionalProperties": false
}Download one Gmail attachment by message_id + attachment_id (from read_gmail_message.attachments). Returns utf-8 text for text/csv/vcf/vcard; binary types return filename/mime/size + a note (no base64 dump). Optional account. Read-only. Requires mail.read on an API key or non-ChatGPT OAuth connection. ChatGPT profiles do not grant mail.read or list this tool. Share tokens cannot call. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| string | ||
| account | string | |
| message_id* | string | |
| attachment_id* | string |
{
"type": "object",
"required": [
"message_id",
"attachment_id"
],
"properties": {
"email": {
"type": "string"
},
"account": {
"type": "string"
},
"message_id": {
"type": "string"
},
"attachment_id": {
"type": "string"
}
},
"additionalProperties": false
}Read one Gmail message by id from search_gmail. Returns subject, from, canonical date, account-local date_local, time_zone, snippet, plain-text body (truncated), and attachments[] metadata (attachment_id, filename, mime_type, size). Use read_gmail_attachment for text/csv/vcf contents. Optional account when multiple mailboxes. On failure returns code gmail_read_failed with retryable: retry once only when retryable; if the newest message still cannot be read, say so and never present an older one as the latest. Read-only. Requires mail.read on an API key or non-ChatGPT OAuth connection. ChatGPT profiles do not grant mail.read or list this tool. Share tokens cannot call. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| id | string | Alias for message_id |
| string | Alias for account | |
| account | string | Mailbox selector (email or connection id) |
| message_id* | string | Gmail message id from search_gmail |
{
"type": "object",
"required": [
"message_id"
],
"properties": {
"id": {
"type": "string",
"description": "Alias for message_id"
},
"email": {
"type": "string",
"description": "Alias for account"
},
"account": {
"type": "string",
"description": "Mailbox selector (email or connection id)"
},
"message_id": {
"type": "string",
"description": "Gmail message id from search_gmail"
}
},
"additionalProperties": false
}Append a private trend for explicit subject_type self, or a person through a matching condition_id/person_id. Corrections supersede a point and retain history. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| kind* | string | |
| unit | string | Optional scale/unit, e.g. 0-10, boolean, 1-5, minutes. |
| value* | number | string | boolean | A scalar value. Put its scale or measurement in unit. |
| metric* | string | What was measured, e.g. severity, completed, energy or duration_minutes. |
| source* | string | Provenance, e.g. user_reported, condition_checkin, daily_checkin or sleep_record. |
| person_id | string | Owned contact id; required for person. |
| confidence* | number | |
| request_id | string | Client idempotency key (retries return original result). |
| observed_at* |
Atomic expense + optional inventory item creation. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| date | string | YYYY-MM-DD; default today. |
| name* | string | What was bought (also the Inventory item name). Alias: merchant. |
| amount* | number | |
| category | string | Expense category (default purchase); also the item category when inventory_details has none. |
| currency | string | ISO 4217; default USD. |
| merchant | string | Where it was bought; stands in for name when name is missing. |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
| create_inventory | boolean | false = the expense only, no Inventory item (default true). |
| inventory_details |
Mark inventory sold + record sale proceeds with gain/loss. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| date | string | Alias for sold_at. |
| notes | string | |
| amount* | number | Sale proceeds. |
| sold_at | string | YYYY-MM-DD; default today. Alias: date. |
| currency | string | ISO 4217; default USD. |
| request_id | string | Client idempotency key (retries return original result). |
| marketplace | string | Where it sold (the income row's merchant; default "sale"). |
| inventory_id* | string | The item sold (get_inventory / search_inventory). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"inventory_id",
"amount"
],
"properties": {
"date": {
"type": "string",
"description": "Alias for sold_at."
},
"notes": {
"type": "string"
},
"amount": {
"type": "number",
"description": "Sale proceeds."
},
"sold_at": {
"type": "string",
"description": "YYYY-MM-DD; default today. Alias: date."
},
"currency": {
"type": "string",
"description": "ISO 4217; default USD."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"marketplace": {
"type": "string",
"description": "Where it sold (the income row's merchant; default \"sale\")."
},
"inventory_id": {
"type": "string",
"description": "The item sold (get_inventory / search_inventory)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Remove contacts from a contact list (list_id, or list_name as its name or slug). The contacts themselves are unchanged. Returns removed, not_member and not_found. Family follows relationships and is refused (code AUTO_SYNCED_LIST). undo_contact_change(change_id) puts them back. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| list_id | string | Contact list id from list_contact_lists. |
| list_name | string | Contact list name or slug, when list_id is not known. |
| person_ids* | array | Contact ids (at most 500). |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"person_ids"
],
"properties": {
"list_id": {
"type": "string",
"description": "Contact list id from list_contact_lists."
},
"list_name": {
"type": "string",
"description": "Contact list name or slug, when list_id is not known."
},
"person_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Contact ids (at most 500)."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Delete one person_accounts row by account id (owner-checked). Simple write-delete of a presence row (not a reviewed contact delete). ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| account_id* | string | |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"account_id"
],
"properties": {
"account_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Preview first, 30-day undo. Remove one alias from a CRM person. Reviewed and reversible: first call preview_destructive_change({ tool: "remove_person_alias", arguments: { person_id, alias } }), which stores the exact change without applying it. After the user confirms, call remove_person_alias with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. Restore brings back the alias with its kind, source and confidence. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| alias* | string | |
| person_id* | string | |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged* | boolean | Must be true after reviewing the preview and its 30-day restore window. |
Preview first, 30-day undo. Resets a sobriety/streak tracker for the authenticated user (sets current value to 0 and restarts the clock). Prefer tracker_id from get_trackers, or tracker_title fuzzy match; optional reset_at (ISO) and note go in the preview arguments. Rebuilds life_state. Reviewed and reversible: first call preview_destructive_change({ tool: "reset_tracker", arguments: { tracker_id } }), which stores the exact change without applying it. After the user confirms, call reset_tracker with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. Restore puts back the previous start date, streak and reset count. Requires API key or OAuth with context.delete. Share tokens cannot write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| note | string | Optional note stored in tracking history |
| title | string | Alias of tracker_title |
| reset_at | string | ISO datetime of the reset (default now) |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| tracker_id |
Link a clarification surface to an existing person. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| person_id | string | |
| request_id | string | Client idempotency key (retries return original result). |
| person_name | string | |
| idempotency_key | string | Alias for request_id. |
| clarification_id* | string |
{
"type": "object",
"required": [
"clarification_id"
],
"properties": {
"person_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"person_name": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"clarification_id": {
"type": "string"
}
},
"additionalProperties": false
}Pending Replies: mark a reply done: sent (default; the user replied, logged privately in the contact's history) or dismissed. Dayze sends nothing. By reply_id, or person_name / person_id when that person has exactly one unsent reply (otherwise the candidates come back and nothing changes). Marking sent writes one private interaction for the linked contact (not for an unlinked reply, and not twice); interaction in the result says what was written. Reopen with update_pending_reply status pending. Requires API key or OAuth with context.write. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| outcome | string | |
| reply_id | string | |
| person_id | string | |
| request_id | string | Client idempotency key (retries return original result). |
| person_name | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"properties": {
"outcome": {
"enum": [
"sent",
"dismissed"
],
"type": "string"
},
"reply_id": {
"type": "string"
},
"person_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"person_name": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Resolve a nickname or surface name to a Dayze Contacts row via person_aliases → exact name → slug → unique substring. Returns avatar_url, photo_count, has_photos, and photos[{url,is_primary}] preview; use get_person_photos for full gallery. With financial_details:read, net_worth_assessment has the same sourced fields as the Contacts card; context-only evidence carries no personal number. Notes omitted unless include_notes=true (redacted). person.lists names the contact lists they are on. Prefer this before money or relationship tools when the agent only has a nickname. Advertised name resolve_person is stable; tools/call also accepts resolve_contact. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| name* | string | Nickname or display name to resolve |
| query | string | Alias for name |
| include_notes | boolean | Include redacted notes (default false) |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Nickname or display name to resolve"
},
"query": {
"type": "string",
"description": "Alias for name"
},
"include_notes": {
"type": "boolean",
"default": false,
"description": "Include redacted notes (default false)"
}
},
"additionalProperties": false
}Canonicalize a venue name via place aliases and fuzzy match. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| name | string | |
| place | string | |
| query | string |
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"place": {
"type": "string"
},
"query": {
"type": "string"
}
},
"additionalProperties": false
}Undo a reviewed destructive change by restore_id within 30 days: deleted rows come back with their links, archived or overwritten fields revert, and inserted history rows are removed. Refuses if the record was edited since; repeats are no-ops. Call-time aliases: restore_food, restore_place, restore_inventory_item, restore_asset, restore_tracker, restore_memory. Contact deletes/merges use undo_contact_change; event/expense/trip archives use restore_event/restore_expense/restore_trip. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| request_id | string | Optional idempotency key. |
| restore_id* | string | restore_id returned by the destructive tool. |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"restore_id"
],
"properties": {
"request_id": {
"type": "string",
"description": "Optional idempotency key."
},
"restore_id": {
"type": "string",
"description": "restore_id returned by the destructive tool."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Restore an archive or normalization receipt. Requires restore_id and request_id. Receipts stay restorable for at least 30 days (archived rows are retained, not purged). Refuses intervening edits; repeats are no-ops. ($0; API key required)
| Argument | Type | Description |
|---|---|---|
| request_id* | string | |
| restore_id* | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"restore_id",
"request_id"
],
"properties": {
"request_id": {
"type": "string"
},
"restore_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Restore an archive or normalization receipt. Requires restore_id and request_id. Receipts stay restorable for at least 30 days (archived rows are retained, not purged). Refuses intervening edits; repeats are no-ops. ($0; API key required)
| Argument | Type | Description |
|---|---|---|
| request_id* | string | |
| restore_id* | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"restore_id",
"request_id"
],
"properties": {
"request_id": {
"type": "string"
},
"restore_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Restore an archive or normalization receipt. Requires restore_id and request_id. Receipts stay restorable for at least 30 days (archived rows are retained, not purged). Refuses intervening edits; repeats are no-ops. ($0; API key required)
| Argument | Type | Description |
|---|---|---|
| request_id* | string | |
| restore_id* | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"restore_id",
"request_id"
],
"properties": {
"request_id": {
"type": "string"
},
"restore_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Restore an archive or normalization receipt. Requires restore_id and request_id. Receipts stay restorable for at least 30 days (archived rows are retained, not purged). Refuses intervening edits; repeats are no-ops. ($0; API key required)
| Argument | Type | Description |
|---|---|---|
| request_id* | string | |
| restore_id* | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"restore_id",
"request_id"
],
"properties": {
"request_id": {
"type": "string"
},
"restore_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Score likely CRM duplicate pairs before merge_people. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| person_id | string | Score against one person; omit for global scan. |
| min_probability | number |
{
"type": "object",
"properties": {
"limit": {
"type": "number"
},
"person_id": {
"type": "string",
"description": "Score against one person; omit for global scan."
},
"min_probability": {
"type": "number"
}
},
"additionalProperties": false
}Search the authenticated user life graph. Optional from/to (aliases start/end) are inclusive account-local civil dates on every search route; either bound may be used alone. Dated semantic and keyword records use event date, expense date, goal start date, check-in date, or the account-local creation date of contacts and memories. Deterministic routing first: food or relative dates (e.g. "what did I eat yesterday?"); timeline/current-context; money+person; who-is → resolve_person. Otherwise semantic/keyword search. Event hits include event_date and food_id when mirrored from Food Diary. Browser-history titles are excluded. Credential/secret spans are redacted. Records carry inspect_url (their Dayze page): cite with it, never build a link from an id; a record without one has no page (inspect_note says which). Requires OAuth or a supported scoped credential. ($0.15; API key required)
| Argument | Type | Description |
|---|---|---|
| q | string | Alias for query. |
| to | string | Inclusive account-local YYYY-MM-DD upper bound for all search routes. May be used alone. |
| end | string | Alias for to. |
| from | string | Inclusive account-local YYYY-MM-DD lower bound for all search routes. May be used alone. |
| limit | number | Max results 1–50 |
| query | string | Primary search query. |
Search one of the authenticated user's connected Gmail inboxes (read-only). Reuses Integrations hub Gmail (service_connections provider=gmail). Optional account/email selects a mailbox when multiple are connected — call list_gmail_accounts first. Prefer Gmail operators: from:, subject:, is:unread, newer_than:7d, has:attachment. For clock-time constraints, pass after/before as account-local civil datetimes; the tool converts them to precise UTC instants. Returns id, subject, from, canonical date, account-local date_local, time_zone, and snippet only (no body), newest first (newest_first: true). For the latest / most recent email from someone, query from:<sender> alone, without quoted topic phrases (the newest reply often lacks them); a from: + topic search with no match from the last 7 days also searches the sender alone and marks those messages sender_only (see note). Follow up with read_gmail_message. Cannot send, archive, or delete. Never invent email contents. If Gmail is not connected, connect at /integrations. Requires mail.read on an API key or non-ChatGPT OAuth connection. ChatGPT profiles do not grant mail.read or list this tool. Share tokens cannot call this tool. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| q | string | Alias for query |
| after | string | Exclusive lower bound as account-local YYYY-MM-DDTHH:mm, or an offset-aware ISO instant |
| string | Alias for account | |
| query* | string | Gmail search query, e.g. "is:unread newer_than:7d", "from:airline subject:itinerary", "receipt newer_than:30d" |
Search owned Inventory by name, brand, model, notes or reference number (query), with the same filters as get_inventory. Returns photo_count, has_photos, cover_url; when empty, photo_hint explains upload_asset linkage. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| limit | number | 1-200, default 50 |
| query | string | Match name, brand, model, notes or reference number. |
| offset | number | |
| status | string | |
| sort_by | string | |
| category | string | e.g. electronics, watches, clothing |
| include_archived | boolean | Include archived and no-longer-owned items. |
| include_sensitive | boolean | API keys only: include stored identifiers. Ignored for connectors without pii:read. |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "1-200, default 50"
},
"query": {
"type": "string",
"description": "Match name, brand, model, notes or reference number."
},
"offset": {
"type": "number"
},
"status": {
"enum": [
"wishlist",
"ordered",
"owned",
"listed_for_sale",
"sold",
"returned",
"lost",
"disposed",
"donated",
"archived"
],
"type": "string"
},
"sort_by": {
"enum": [
"created_at",
"name",
"value"
],
"type": "string"
},
"category": {
"type": "string",
"description": "e.g. electronics, watches, clothing"
},
"include_archived": {
"type": "boolean",
"description": "Include archived and no-longer-owned items."
},
"include_sensitive": {
"type": "boolean",
"description": "API keys only: include stored identifiers. Ignored for connectors without pii:read."
}
},
"additionalProperties": false
}Search only owned Moment stories and titles within an optional date range. Returns stable moment_ids. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | YYYY-MM-DD inclusive |
| from | string | YYYY-MM-DD inclusive |
| limit | integer | |
| query* | string | |
| offset | integer |
{
"type": "object",
"required": [
"query"
],
"properties": {
"to": {
"type": "string",
"description": "YYYY-MM-DD inclusive"
},
"from": {
"type": "string",
"description": "YYYY-MM-DD inclusive"
},
"limit": {
"type": "integer"
},
"query": {
"type": "string"
},
"offset": {
"type": "integer"
}
},
"additionalProperties": false
}Search person photos and entity assets by query/metadata. Returns inline MCP image attachments. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| to | string | Inclusive YYYY-MM-DD: photos added on or before this day (UTC). |
| from | string | Inclusive YYYY-MM-DD: photos added on or after this day (UTC). |
| limit | number | Max photos 1-50, default 20. |
| query | string | |
| place_id | string | |
| person_ids | array |
{
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Inclusive YYYY-MM-DD: photos added on or before this day (UTC)."
},
"from": {
"type": "string",
"description": "Inclusive YYYY-MM-DD: photos added on or after this day (UTC)."
},
"limit": {
"type": "number",
"description": "Max photos 1-50, default 20."
},
"query": {
"type": "string"
},
"place_id": {
"type": "string"
},
"person_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}Search individual transaction rows by merchant/description/category, or exact tag (project:/ext:/rail:). Requires context.read and financial_details:read. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| tag | string | |
| limit | number | Page size 1-500, default 100. |
| query | string | |
| cursor | string | Continue the same immutable one-hour snapshot; other filters remain frozen. |
| offset | number | Skip this many rows of a new snapshot (a cursor carries its own). |
| project | string | |
| include_archived | boolean |
{
"type": "object",
"properties": {
"tag": {
"type": "string"
},
"limit": {
"type": "number",
"description": "Page size 1-500, default 100."
},
"query": {
"type": "string"
},
"cursor": {
"type": "string",
"description": "Continue the same immutable one-hour snapshot; other filters remain frozen."
},
"offset": {
"type": "number",
"description": "Skip this many rows of a new snapshot (a cursor carries its own)."
},
"project": {
"type": "string"
},
"include_archived": {
"type": "boolean"
}
},
"additionalProperties": false
}Upsert a platform account on a Dayze Contact (Instagram, Dayze, ChatGPT, …). Multiple accounts per platform are allowed (kind + optional label + is_primary). Pass account_id to update a specific row; otherwise upsert by person+platform+handle+kind. Agents may set status likely|self_reported|unknown (default likely); verified is reserved for server derivation. source is stored as agent. platform=other requires label (site name). ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| url | string | |
| kind | string | personal | work | portfolio | other (default personal) |
| label | string | Free-text note (e.g. photography). Required site name when platform=other. |
| notes | string | |
| handle | string | |
| status | string | likely | self_reported | unknown (verified is server-only) |
| platform* | string | dayze|chatgpt|claude|codex|cursor|gemini|instagram|facebook|linkedin|x|tiktok|youtube|github|threads|telegram|whatsapp|lawve|other |
| person_id* | string | |
Rename a CRM contact’s canonical name and refresh slug. By default preserves the old name as a former_name alias. Prefer this over create+merge for spelling fixes. Dayze is the context layer — bounded mutation only. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| person_id* | string | |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
| preserve_old_name_as_alias | boolean |
{
"type": "object",
"required": [
"person_id",
"name"
],
"properties": {
"name": {
"type": "string"
},
"person_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"preserve_old_name_as_alias": {
"type": "boolean"
}
},
"additionalProperties": false
}Server-side cleanup audit. Records the audit run and returns a review queue; it never changes, merges or deletes contacts, so there is nothing to undo. Apply candidates with merge_people_preview → merge_people or normalize_people_preview → normalize_people_apply (both reversible for 30 days). ($0.15; API key required)
| Argument | Type | Description |
|---|---|---|
| checks | array | |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
| auto_merge_threshold | number |
{
"type": "object",
"properties": {
"checks": {
"type": "array",
"items": {
"type": "string"
}
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"auto_merge_threshold": {
"type": "number"
}
},
"additionalProperties": false
}Reverse a reversible contact change (rename, alias, identity, classify, link). For merges, deletes, unlink_people, remove_person_alias and convert_contact_entity, pass restore_id as change_id within 30 days. Restore rejects later edits rather than overwriting them. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| change_id* | string | |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"change_id"
],
"properties": {
"change_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Undo an owned event fact correction by ledger ID. Supply request_id for safe retries. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| request_id* | string | |
| correction_id* | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"correction_id",
"request_id"
],
"properties": {
"request_id": {
"type": "string"
},
"correction_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Preview first, 30-day undo. Remove a person↔person graph edge (by connection_id, or person_id + other_person_id). Reviewed and reversible: first call preview_destructive_change({ tool: "unlink_people", arguments: { connection_id } }), which stores the exact change without applying it. After the user confirms, call unlink_people with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| person_id | string | |
| preview_id* | string | preview_id returned by preview_destructive_change for this tool. |
| request_id* | string | Required idempotency key; retries return the original receipt. |
| connection_id | string | |
| idempotency_key | string | Alias for request_id. |
| other_person_id | string | |
| restore_window_acknowledged* | boolean |
Patch role, metadata, description, or parent_asset_id (e.g. mark as processed). ($0.08; API key required)
| Argument | Type | Description |
|---|---|---|
| role | string | original | cover | thumbnail | … |
| asset_id* | string | |
| filename | string | |
| metadata | object | Free-form metadata, merged into the stored metadata (metadata.source becomes the asset source). |
| asset_type | string | |
| request_id | string | Client idempotency key (retries return original result). |
| description | string | |
| idempotency_key | string | Alias for request_id. |
| parent_asset_id | string |
{
"type": "object",
"required": [
"asset_id"
],
"properties": {
"role": {
"enum": [
"original",
"processed",
"thumbnail",
"cover",
"document",
"receipt",
"certificate",
"photo",
"other"
],
"type": "string",
"description": "original | cover | thumbnail | …"
},
"asset_id": {
"type": "string"
},
"filename": {
"type": "string"
},
"metadata": {
"type": "object",
"description": "Free-form metadata, merged into the stored metadata (metadata.source becomes the asset source)."
},
"asset_type": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"description": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"parent_asset_id": {
"type": "string"
}
},
"additionalProperties": false
}Patch a condition by condition_id with its explicit subject_type (and person_id for a contact). The subject must match. Patch status, confirmation_status, source or condition fields; omitted fields stay untouched and null clears nullable text. Never infer active/confirmed. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| name | string | What the user calls it, in their words (e.g. "Blurry near vision"). Never a diagnosis they did not give. |
| notes | string | |
| source | string | Provenance, e.g. user_reported. Default user_reported. |
| status | string | suspected (default for a new one) | active | improving | resolved. |
| symptoms | string | What they notice, e.g. "Blurry at near distance, worse in the evening". |
| body_area | string | Where, e.g. "Left eye". |
| person_id | string | Owned contact id; required for person. |
| request_id | string | Client idempotency key (retries return original result). |
| started_on | string | YYYY-MM-DD it started (onset). Default for a new one: today. |
MUTATES where the user is now: profiles.location + polaris current_city/country (same as in-app Dayze chat). Pass location ("The Madeira, Singapore") and/or city+country; optional place/venue + lat/lon records a fresh location_visits check-in so get_location_context returns is_current. set_home defaults true; check_in defaults true when place or coordinates are set. Does not invent GPS when omitted. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| city | string | |
| place | string | Venue / residence name (e.g. The Madeira) |
| venue | string | Alias for place |
| address | string | |
| country | string | |
| check_in | boolean | Write a location_visits row when place or coordinates are set (default true in that case) |
| latitude | number | |
| location | string | Freeform “City, Country” or “Venue, City, Country” |
| set_home | boolean | Also write profiles.location / home_location (default true) |
MUTATES one existing calendar event the authenticated user owns. Required: event_id (UUID). Optional patch (same fields as log_event): title, date / event_date, time / event_time, end_date, end_time, location, description (alias notes), category, external_url, image_url, timezone, visibility, people / with / person_ids, scoreboard (merged; null clears), reminder_enabled (false turns the push reminder off; needs a timed event to turn on), reminder_minutes_before. Adds a bedtime to a wake-only sleep: event_time (and event_date / end_date when it was the night before). Unknown or other-user event_id returns an error and does not create a row. For food-diary meals, prefer update_food (it syncs the mirrored event). Rebuilds life_state. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| date | string | Alias for event_date. |
| time | string | Alias for event_time. |
| with | array | Alias for people. |
| notes | string | Alias for description. |
| title | string | Updated title (replaces). Cannot be empty. |
| people | array | People names or person UUIDs to add (event_people role=with). Does not remove existing tags. |
| category | string | e.g. sleep, funeral, family, work, travel. Stored as events.category and event_type. |
PATCH an expense row. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| date | string | YYYY-MM-DD expense_date |
| tags | array | |
| notes | string | |
| amount | number | |
| source | string | Alias of payment_method |
| project | string | Venture label → project:{slug} tag |
| category | string | |
| currency | string | |
| merchant | string | |
| expense_id* | string | |
| request_id | string | Client idempotency key (retries return original result). |
| description | string |
MUTATES one existing Food Diary row the authenticated user owns. Required: food_id (UUID). Optional patch (same fields as log_food): what, kind, contains_alcohol, dish_items, place, merchant, notes, append_notes (concat), consumed_at (ISO instant) / meal_period (profile TZ), amount, currency, paid_by (self / a name / unknown), payment_method (how it was paid, saved on the linked Finance transaction), expense_id (link one existing owned Finance transaction; null unlinks), with / people_names / person_ids. dish_items replaces the complete ordered dish list. A dish or notes correction never creates another Finance transaction. Unknown or other-user food_id or expense_id returns an error and changes nothing. Returns changed fields and a fresh linked_expense read. Syncs the mirrored calendar event and rebuilds life_state. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| food | string | Alias for what. |
| item | string | Alias for what. |
| kind | string | |
| what | string | Full updated dish/drink text (replaces, does not append). Example: Salmon Bento + hot tea |
| with | array | Companion names, aliases, or ids to add (does not remove existing tags) |
| notes | string | Replaces notes. Empty or null clears |
| place | string |
Patch one owned Inventory item, found by inventory_id or by nickname: what the user calls it ("MacBook", "work laptop"), matched to exactly one of their active items by nickname, name or model, so there is no need to look it up first; several matches are refused with the candidates and nothing changes. Fields you leave out are untouched. specs merge per key (null removes a key), so updating memory keeps storage. state records a new observation (observed_at, source, confidence) and never changes specs or notes; a key already observed more recently is kept. spec_template switches or clears (null) the template. A status like sold or donated moves it out of the active list; to archive, use archive_inventory_item. Never add device or account identifiers. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| name | string | What the user calls the item, e.g. "MacBook Pro 14 (2023)". |
| tags | array | Replaces the tag list. |
| brand | string | |
| model | string | |
| notes | string | Free text from the user. |
| specs | object | Stable facts, by the template's field names (computer.v1: nickname, manufacturer, model_name, model_identifier, year, primary_uses, capability_tags, product_family, form_factor, chip, cpu, architecture, performance_cores, efficiency_cores, total_cores, threads, gpu, gpu_cores, gpu_memory_bytes, neural_engine_cores, memory_bytes, memory, storage_devices, display, ports). Merged per key on update; null removes a key; other keys are kept as written. Only what the user or the device says, never inferred from a model name. Never device or account identifiers. |
Patch one owned moment by moment_id (from log_moment); fields left out are untouched. It stays private. Requires moment_id. Patchable: title, description, moment_date, moment_date_precision, end_date, moment_type, location_name, people, event_id, images, tags. Unknown or other-user moment_id returns an error and creates nothing. person_ids / people_names, media_urls and tags replace the stored list ([] clears); event_id links an owned event (the event is not changed), empty or null unlinks. Visibility is not an argument. Returns changed_fields. Requires API key or OAuth with context.write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| date | string | Alias for moment_date. |
| tags | array | Replaces the tags. [] clears. |
| title | string | New title (max 200). Cannot be empty. |
| end_date | string | YYYY-MM-DD. Empty or null clears. |
| event_id | string | Link the moment to an owned event (the event is not changed). Empty or null unlinks. |
| location | string | Alias for location_name. |
| moment_id* | string | UUID of a moment the user owns (from log_moment). |
| media_urls | array |
MUTATES public notable_people. Superuser only. Patch by slug (bio, about, occupation, birth_place, birth_date, net_worth, residence, before_fame, trivia, family_life, zodiac, flag). Rejects unknown fields. No create/delete. Stamps last_updated_via=mcp. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| bio | string | |
| flag | string | |
| slug* | string | Notable person slug (e.g. taylor-swift) |
| about | string | |
| trivia | string | |
| zodiac | string | |
| net_worth | string | |
| residence | string | |
| birth_date | string | YYYY, YYYY-MM, or YYYY-MM-DD. Null/empty clears |
| occupation | string | |
| request_id | string |
Pending Replies: change one reply by reply_id: its draft (replaces; null clears), summary, channel, category, received_at, person (person_id, or person_name linked only on one match), source, or status pending (reopen / unsnooze) or snoozed with snooze_until. Unknown or other-user reply_id returns not_found. To mark it sent or dismissed use resolve_pending_reply. Never sends anything. Requires API key or OAuth with context.write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| draft | string | The reply text to send later, max 20,000 characters. Replaces the saved draft; empty or null clears. Alias: draft_message. |
| source | object | The email the reply answers, as ids only (e.g. a search_gmail id is a message_id). Never a subject, sender or text. On update, null clears it. |
| status | string | |
| channel | string | Where to reply: whatsapp, email, sms, call, imessage, telegram, instagram, facebook, signal, linkedin, twitter, slack, reddit, teams, work_email, zoom, dayze, other; the platform the conversation is on (a Reddit thread is reddit, an Instagram group instagram). Default email when source is set, else other. |
| summary | string | One line (max 280) in your own words: what the reply is about. Never paste the email body, subject line or sender address. |
| category | string | |
| reply_id |
Patch an existing person↔person graph edge (type/context/source/confidence). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| notes | string | |
| source | string | |
| person_id | string | |
| confidence | number | |
| request_id | string | Client idempotency key (retries return original result). |
| connection_id | string | |
| idempotency_key | string | Alias for request_id. |
| other_person_id | string | |
| relationship_type | string |
{
"type": "object",
"properties": {
"notes": {
"type": "string"
},
"source": {
"type": "string"
},
"person_id": {
"type": "string"
},
"confidence": {
"type": "number"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"connection_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"other_person_id": {
"type": "string"
},
"relationship_type": {
"type": "string"
}
},
"additionalProperties": false
}MUTATES one owned Dayze contact by person_id. A context_tags-only patch is supported; send the full desired tag array (a repeat is a no-op). For personal-write OAuth send request_id, a unique string for each new write; reuse it for an exact retry. Fields left out are untouched. undo_contact_change(change_id) reverts a change. Requires context.write; share tokens cannot write. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| name | string | Rename contact (also refreshes URL slug). Prefer this over create+merge for spelling fixes |
| tier | string | Relationship priority. VIP stays in inner_circle even when not favorited |
| notes | string | Replaces people.notes (does not append). Empty or null clears |
| wallets | array | PHI-930: full list of ENS (.eth) / SNS (.sol) names and/or addresses for this contact. Merged into social_handles (legacy ens/ens_address kept); empty array clears wallet keys only. |
| birthday | string | YYYY, YYYY-MM, YYYY-MM-DD, or MM-DD / --MM-DD (year unknown; 02-29 ok). Null/empty clears |
| person_id* | string | UUID of a person the authenticated user owns |
| request_id | string | Required on personal-write OAuth. Unique for a new write; reuse for an exact retry. |
Update alias_kind/source/display for an existing alias. ($0.05; API key required)
| Argument | Type | Description |
|---|---|---|
| alias* | string | |
| source | string | |
| person_id* | string | |
| alias_kind | string | |
| request_id | string | Client idempotency key (retries return original result). |
| alias_display | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"person_id",
"alias"
],
"properties": {
"alias": {
"type": "string"
},
"source": {
"type": "string"
},
"person_id": {
"type": "string"
},
"alias_kind": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"alias_display": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Patch identity fields (legal/preferred name, pronouns, social handles, user_relationships[]). Never infer sensitive identity from appearance. Confirmed user_relationships are preserved unless force=true. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| force | boolean | |
| aliases | array | |
| website | string | |
| pronouns | string | |
| person_id* | string | |
| legal_name | string | |
| request_id | string | Client idempotency key (retries return original result). |
| preferred_name | string | |
| social_handles | object | |
| idempotency_key | string | Alias for request_id. |
| user_relationships |
Patch a saved place card by place_id / business_contact_id. Unspecified fields stay unchanged (hours, affordability, address, notes, …). ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| id | string | |
| area | string | |
| city | string | |
| name | string | |
| tags | array | |
| hours | string | |
| notes | string | |
| phone | string | |
| address | string | |
| country | string | |
| website | string | |
| category | string | |
Sleep: patch an existing sleep record by sleep_id. ($0.10; API key required)
| Argument | Type | Description |
|---|---|---|
| notes | string | |
| quality | number | |
| ended_at | string | |
| sleep_id* | string | |
| timezone | string | |
| request_id | string | Client idempotency key (retries return original result). |
| sleep_type | string | |
| started_at | string | |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"sleep_id"
],
"properties": {
"notes": {
"type": "string"
},
"quality": {
"type": "number"
},
"ended_at": {
"type": "string"
},
"sleep_id": {
"type": "string"
},
"timezone": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"sleep_type": {
"enum": [
"overnight",
"nap",
"unknown"
],
"type": "string"
},
"started_at": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}Upload image bytes to Dayze storage (normally re-encoded as WebP; original_preserved and metadata_stripped describe the saved bytes). Accepts image_base64, url, or ChatGPT file object `image` ({download_url, file_id}). Returns asset_id, content_type, byte_size, view_url after bytes are confirmed. Temporary ChatGPT download URLs are never stored. For inventory item photos: pass entity_type=inventory, entity_id=inventory_id, role=photo. For receipt photos: entity_type=expense|event, role=receipt. Or upload then attach_asset. ($0.15; API key required)
| Argument | Type | Description |
|---|---|---|
| url | string | Remote image URL to fetch and store. |
| role | string | original | cover | thumbnail | … |
| image | object | ChatGPT chat attachment. Prefer this for images from the conversation; API clients may still use image_base64 or url. |
| filename | string | |
| metadata | object | Free-form metadata, merged into the stored metadata (metadata.source becomes the asset source). |
| entity_id | string | |
| mime_type | string | image/jpeg, image/png, image/webp, … Alias: content_type. |
| asset_type | string | photo | receipt | certificate | document | thumbnail | … |
Upload a photo to a Life Graph entity you have (event, expense, place, person, inventory, …). Accepts image_base64, url, or ChatGPT file object `image` ({download_url, file_id}). Normally re-encodes as WebP; original_preserved and metadata_stripped describe the saved bytes. Partial results include an asset_id for repair: call upload_photo with asset_id and a new request_id, without image bytes. Answers attached: true only after readback confirms asset id, content_type, byte_size, and a viewable URL on the record — never from OCR text alone. Mobile file references without download_url fail clearly (attached: false). Person uploads also write the CRM gallery (person_photos) and avatar when set_as_avatar=true. ($0.15; API key required)
| Argument | Type | Description |
|---|---|---|
| url | string | Remote image URL to fetch and store. |
| role | string | original | cover | thumbnail | receipt | … (photo is stored as original). set_as_avatar implies cover. |
| image | object | ChatGPT chat attachment. Prefer this for images from the conversation; API clients may still use image_base64 or url. |
| title | string | |
| asset_id | string | Repair saved upload: new request_id, no image bytes. |
| filename | string | |
| entity_id* | string | |
{
"type": "object",
"required": [
"inventory_id",
"value"
],
"properties": {
"notes": {
"type": "string"
},
"value": {
"type": "number",
"description": "What it is worth."
},
"source": {
"type": "string",
"description": "Where the value comes from: appraisal, listing, estimate, …"
},
"currency": {
"type": "string",
"description": "ISO 4217, default USD."
},
"valued_at": {
"type": "string",
"description": "ISO date or date-time; default now."
},
"confidence": {
"type": "number",
"description": "0-1"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"inventory_id": {
"type": "string",
"description": "The item id from add_inventory_item, get_inventory or search_inventory."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| Must be true after reviewing the preview and its 30-day restore window. |
{
"type": "object",
"required": [
"inventory_id",
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"reason": {
"type": "string",
"description": "Why it is archived (kept on the receipt)."
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"inventory_id": {
"type": "string",
"description": "The item id from add_inventory_item, get_inventory or search_inventory."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"entity_type",
"entity_id"
],
"properties": {
"url": {
"type": "string",
"description": "A web link (https://…) to an image. Not a storage path: upload a file, then attach its asset_id."
},
"role": {
"enum": [
"original",
"processed",
"thumbnail",
"cover",
"document",
"receipt",
"certificate",
"photo",
"other"
],
"type": "string",
"description": "original | cover | thumbnail | …"
},
"asset_id": {
"type": "string"
},
"metadata": {
"type": "object",
"description": "Free-form metadata, merged into the stored metadata (metadata.source becomes the asset source)."
},
"entity_id": {
"type": "string"
},
"asset_type": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"description": {
"type": "string",
"description": "Caption for the attached asset (kept on a linked copy too)."
},
"entity_type": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| true keeps the entry time even if the photo EXIF has a capture time |
{
"type": "object",
"required": [
"food_id"
],
"properties": {
"url": {
"type": "string",
"description": "Public https image URL to fetch and store. Use this or image_base64."
},
"food_id": {
"type": "string",
"description": "UUID of a Food Diary row the authenticated user owns"
},
"filename": {
"type": "string",
"description": "Optional original filename"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"image_base64": {
"type": "string",
"description": "Image bytes as base64 (optional data:image/...;base64, prefix). Use this or url."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"keep_consumed_at": {
"type": "boolean",
"description": "true keeps the entry time even if the photo EXIF has a capture time"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"reason": {
"type": "string"
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"entity_type": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}| boolean |
| Must be true after reviewing the preview and its 30-day restore window. |
{
"type": "object",
"required": [
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"entity_id": {
"type": "string"
},
"person_id": {
"type": "string"
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"target_type": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}| started_on |
| string |
| YYYY-MM-DD it started (onset). Default for a new one: today. |
| treatments | string | What they use or do for it. |
| subject_type* | string | self, or person with person_id. |
| tracking_focus | string | What to watch on each check-in. |
| idempotency_key | string | Alias for request_id. |
| confirmation_status | string | unconfirmed | reported (default) | confirmed; never infer confirmed. |
{
"type": "object",
"required": [
"name",
"subject_type"
],
"properties": {
"name": {
"type": "string",
"description": "What the user calls it, in their words (e.g. \"Blurry near vision\"). Never a diagnosis they did not give."
},
"notes": {
"type": "string"
},
"source": {
"type": "string",
"description": "Provenance, e.g. user_reported. Default user_reported."
},
"status": {
"enum": [
"suspected",
"active",
"improving",
"resolved"
],
"type": "string",
"description": "suspected (default for a new one) | active | improving | resolved."
},
"symptoms": {
"type": "string",
"description": "What they notice, e.g. \"Blurry at near distance, worse in the evening\"."
},
"body_area": {
"type": "string",
"description": "Where, e.g. \"Left eye\"."
},
"person_id": {
"type": "string",
"description": "Owned contact id; required for person."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"started_on": {
"type": "string",
"description": "YYYY-MM-DD it started (onset). Default for a new one: today."
},
"treatments": {
"type": "string",
"description": "What they use or do for it."
},
"subject_type": {
"enum": [
"self",
"person"
],
"type": "string",
"description": "self, or person with person_id."
},
"tracking_focus": {
"type": "string",
"description": "What to watch on each check-in."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"confirmation_status": {
"enum": [
"unconfirmed",
"reported",
"confirmed"
],
"type": "string",
"description": "unconfirmed | reported (default) | confirmed; never infer confirmed."
}
},
"additionalProperties": false
}| Default personal. |
| person_id | string | An owned contact id; links that contact directly. |
| request_id | string | Client idempotency key (retries return original result). |
| person_name* | string | Who the reply is owed to, as the user said it (e.g. "Ilana"). |
| received_at | string | When they wrote (ISO date-time). Default now. |
| draft_message | string | Alias for draft. |
| idempotency_key | string | Alias for request_id. |
| update_existing | boolean | When an unsent reply for this thread or person exists, write draft/summary onto it instead of returning it unchanged. |
{
"type": "object",
"required": [
"person_name"
],
"properties": {
"draft": {
"type": "string",
"description": "The reply text to send later, max 20,000 characters. Replaces the saved draft; empty or null clears. Alias: draft_message."
},
"source": {
"type": "object",
"properties": {
"kind": {
"enum": [
"gmail",
"email",
"other"
],
"type": "string"
},
"thread_id": {
"type": "string"
},
"message_id": {
"type": "string"
}
},
"description": "The email the reply answers, as ids only (e.g. a search_gmail id is a message_id). Never a subject, sender or text. On update, null clears it.",
"additionalProperties": false
},
"channel": {
"type": "string",
"description": "Where to reply: whatsapp, email, sms, call, imessage, telegram, instagram, facebook, signal, linkedin, twitter, slack, reddit, teams, work_email, zoom, dayze, other; the platform the conversation is on (a Reddit thread is reddit, an Instagram group instagram). Default email when source is set, else other."
},
"summary": {
"type": "string",
"description": "One line (max 280) in your own words: what the reply is about. Never paste the email body, subject line or sender address."
},
"category": {
"enum": [
"personal",
"work"
],
"type": "string",
"description": "Default personal."
},
"person_id": {
"type": "string",
"description": "An owned contact id; links that contact directly."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"person_name": {
"type": "string",
"description": "Who the reply is owed to, as the user said it (e.g. \"Ilana\")."
},
"received_at": {
"type": "string",
"description": "When they wrote (ISO date-time). Default now."
},
"draft_message": {
"type": "string",
"description": "Alias for draft."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"update_existing": {
"type": "boolean",
"description": "When an unsent reply for this thread or person exists, write draft/summary onto it instead of returning it unchanged."
}
},
"additionalProperties": false
}| is_favorite | boolean |
| context_tags | array |
| relationship | string |
| relationships | array |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"tier": {
"enum": [
"vip",
"normal",
"low"
],
"type": "string"
},
"email": {
"type": "string"
},
"notes": {
"type": "string"
},
"phone": {
"type": "string"
},
"aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"wallets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"chain": {
"enum": [
"eth",
"base",
"sol"
],
"type": "string"
},
"address": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "PHI-930: ENS (.eth) / SNS (.sol) names and/or addresses for this contact. Stored in social_handles (legacy ens/ens_address kept)."
},
"birthday": {
"type": "string",
"description": "YYYY-MM-DD, YYYY-MM, YYYY, or MM-DD / --MM-DD when the year is unknown (same as update_person)"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"is_favorite": {
"type": "boolean"
},
"context_tags": {
"type": "array",
"items": {
"type": "string"
}
},
"relationship": {
"type": "string"
},
"relationships": {
"type": "array",
"items": {
"type": "string"
}
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| latitude |
| number |
| longitude | number |
| request_id | string | Client idempotency key (retries return original result). |
| description | string |
| price_level | string | Alias for affordability |
| hours_source | string | agent | google_places | user |
| affordability | string | $ | $$ | $$$ (or 1–3) |
| opening_hours | string |
| phone_numbers | array |
| idempotency_key | string |
{
"type": "object",
"required": [
"name"
],
"properties": {
"area": {
"type": "string"
},
"city": {
"type": "string"
},
"name": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"hours": {
"type": "string",
"description": "Alias for opening_hours"
},
"notes": {
"type": "string"
},
"phone": {
"type": "string"
},
"address": {
"type": "string"
},
"country": {
"type": "string"
},
"website": {
"type": "string"
},
"category": {
"type": "string",
"description": "restaurant|cafe|supermarket|shop|hawker|… (aliases mapped to business_contacts.category)"
},
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"description": {
"type": "string"
},
"price_level": {
"type": "string",
"description": "Alias for affordability"
},
"hours_source": {
"type": "string",
"description": "agent | google_places | user"
},
"affordability": {
"type": "string",
"description": "$ | $$ | $$$ (or 1–3)"
},
"opening_hours": {
"type": "string"
},
"phone_numbers": {
"type": "array",
"items": {
"type": "string"
}
},
"idempotency_key": {
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"food_id",
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"food_id": {
"type": "string",
"description": "UUID of a Food Diary row the authenticated user owns"
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}| Must be true after reviewing the preview and its 30-day restore window. |
{
"type": "object",
"required": [
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"memory_id": {
"type": "string",
"description": "Optional: the memory the preview named (checked against it). A preview of several memory_ids names none."
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}| boolean |
| Must be true after reviewing the preview and its 30-day restore window. |
{
"type": "object",
"required": [
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"id": {
"type": "string"
},
"place_id": {
"type": "string"
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"business_contact_id": {
"type": "string"
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"visit_id",
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"visit_id": {
"type": "string",
"description": "UUID of a place_visits row: visit_id from get_place_visits or log_place_visit."
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}| include_places | boolean | Include recent canonical places. |
| include_location | boolean | Include city/country label; never returns a precise address |
| include_memories | boolean | Include recent memories. |
| include_place_visits | boolean | Include recent venue visits; never a GPS trail |
| include_quiz_results | boolean | Include latest quiz results. |
| include_relationships | boolean | Include people and relationship context. |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Alias for query."
},
"at": {
"type": "string",
"description": "ISO date-time to answer as of (default now), e.g. 2026-09-26T09:00:00+08:00."
},
"focus": {
"type": "string",
"description": "Optional focus hint echoed in the pack (e.g. places, travel, people)"
},
"query": {
"type": "string",
"description": "Question that guides facts and memories."
},
"timezone": {
"type": "string",
"description": "IANA time zone for today (default: where the user is now, else their home zone)."
},
"include_money": {
"type": "boolean",
"default": false,
"description": "Include the private cashflow summary"
},
"include_trips": {
"type": "boolean",
"default": false,
"description": "Include recent/upcoming trips from completed travel history"
},
"include_places": {
"type": "boolean",
"default": false,
"description": "Include recent canonical places."
},
"include_location": {
"type": "boolean",
"default": false,
"description": "Include city/country label; never returns a precise address"
},
"include_memories": {
"type": "boolean",
"default": true,
"description": "Include recent memories."
},
"include_place_visits": {
"type": "boolean",
"default": true,
"description": "Include recent venue visits; never a GPS trail"
},
"include_quiz_results": {
"type": "boolean",
"default": true,
"description": "Include latest quiz results."
},
"include_relationships": {
"type": "boolean",
"default": true,
"description": "Include people and relationship context."
}
},
"additionalProperties": false
}| offset | number | Skip this many matching rows of a new snapshot (a cursor carries its own). |
| date_to | string | Alias for to. |
| timezone | string | IANA time zone for today (default: where the user is now, else their home zone). |
| date_from | string | Alias for from. |
| redact_pii | boolean | true: redact contact details, card and account numbers and secrets in description, location and scoreboard, even where this connection may see them. Never unredacts: without travel_secrets:read they are always redacted. |
| event_kinds | array | Alias for kinds. |
| include_archived | boolean |
| include_browsing | boolean | Include extension "Browsed domain · Xm" auto-events (default false) |
| include_calendar_blocks | boolean | Include Focus Time / calendar_block rows (default false) |
{
"type": "object",
"properties": {
"at": {
"type": "string",
"description": "ISO date-time to answer as of (default now), e.g. 2026-09-26T09:00:00+08:00."
},
"to": {
"type": "string",
"description": "Inclusive YYYY-MM-DD"
},
"from": {
"type": "string",
"description": "Inclusive YYYY-MM-DD (preferred over range)"
},
"kinds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by event_kind: life_event, calendar_block, todo, goal, travel_segment, food_log, health_record, transaction, media_log, work, family, personal. Alias \"food\" (also meal/drink/snack) matches the displayed Food category: food_log rows plus Meal/Drink/Snack life_events. total/has_more count only matching rows."
},
"limit": {
"type": "number",
"maximum": 500,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 300,
"description": "Literal substring in title, description or location."
},
"range": {
"enum": [
"today",
"week",
"month",
"year",
"decade",
"all"
],
"type": "string"
},
"cursor": {
"type": "string"
},
"offset": {
"type": "number",
"description": "Skip this many matching rows of a new snapshot (a cursor carries its own)."
},
"date_to": {
"type": "string",
"description": "Alias for to."
},
"timezone": {
"type": "string",
"description": "IANA time zone for today (default: where the user is now, else their home zone)."
},
"date_from": {
"type": "string",
"description": "Alias for from."
},
"redact_pii": {
"type": "boolean",
"description": "true: redact contact details, card and account numbers and secrets in description, location and scoreboard, even where this connection may see them. Never unredacts: without travel_secrets:read they are always redacted."
},
"event_kinds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Alias for kinds."
},
"include_archived": {
"type": "boolean"
},
"include_browsing": {
"type": "boolean",
"description": "Include extension \"Browsed domain · Xm\" auto-events (default false)"
},
"include_calendar_blocks": {
"type": "boolean",
"description": "Include Focus Time / calendar_block rows (default false)"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [],
"properties": {
"at": {
"type": "string",
"description": "Optional ISO instant to read \"today\" at (defaults to now)."
},
"to": {
"type": "string",
"description": "Last civil day, YYYY-MM-DD, inclusive."
},
"date": {
"type": "string",
"description": "Alias for from (one day)."
},
"from": {
"type": "string",
"description": "First civil day, YYYY-MM-DD, in the account timezone. Alone = that one day. Default: today."
},
"category": {
"type": "string",
"description": "Optional expense category to total, matched case-insensitively (e.g. food, transport)."
},
"currency": {
"type": "string",
"description": "Optional 3-letter display currency (e.g. SGD)."
},
"timezone": {
"type": "string",
"description": "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."
}
},
"additionalProperties": false
}| string |
| Venue/merchant substring |
{
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Inclusive YYYY-MM-DD"
},
"from": {
"type": "string",
"description": "Inclusive YYYY-MM-DD"
},
"limit": {
"type": "number",
"description": "Max 1–50, default 25"
},
"event_id": {
"type": "string"
},
"place_id": {
"type": "string"
},
"person_id": {
"type": "string"
},
"expense_id": {
"type": "string"
},
"person_name": {
"type": "string"
},
"place_query": {
"type": "string",
"description": "Venue/merchant substring"
}
},
"additionalProperties": false
}| Include recent memory summaries (default true; set false to omit) |
| include_relationships | boolean | Include inner-circle and relationship summaries (default true; set false to omit) |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Alias for query."
},
"at": {
"type": "string",
"description": "ISO date-time to answer as of (default now), e.g. 2026-09-26T09:00:00+08:00."
},
"query": {
"type": "string",
"maxLength": 500,
"description": "Optional question. Drives the question-aware facts slice (family, names, dates, merchants) returned in facts/trace."
},
"timezone": {
"type": "string",
"description": "IANA time zone for today (default: where the user is now, else their home zone)."
},
"include_money": {
"type": "boolean",
"default": false,
"description": "Include money facts in the question-aware facts slice (opt-in; the grant must allow financial details)."
},
"include_location": {
"type": "boolean",
"default": false,
"description": "Include city/country label; never returns a precise address"
},
"include_memories": {
"type": "boolean",
"default": true,
"description": "Include recent memory summaries (default true; set false to omit)"
},
"include_relationships": {
"type": "boolean",
"default": true,
"description": "Include inner-circle and relationship summaries (default true; set false to omit)"
}
},
"additionalProperties": false
}| query |
| string |
| Literal substring search over name, slug, email, occupation and context tags; with wealth_category=reviewed, name only. No fuzzy fallback. |
| cursor | string |
| offset | number | Skip N rows (default 0) |
| occupation | string | Require this literal substring in the occupation field. Cannot combine with wealth_category. |
| context_tags | array | Require every exact context tag, case insensitive (for example ["model"]). Cannot combine with wealth_category. |
| include_lists | boolean | When true, each contact includes lists: [{ id, name, slug }]. Default false. |
| include_notes | boolean | When true, include notes (server-redacted). Default false. |
| wealth_category | string | Only explicitly owner-reviewed wealth-category contacts. Returns id and name only; cannot combine with occupation or context_tags. |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Page size (default 100, max 500)"
},
"lists": {
"type": "array",
"items": {
"type": "string"
},
"description": "Only contacts on any of these contact lists (ids or slugs from list_contact_lists), by name; page with offset. Cannot combine with query, occupation, context_tags, wealth_category or cursor."
},
"query": {
"type": "string",
"description": "Literal substring search over name, slug, email, occupation and context tags; with wealth_category=reviewed, name only. No fuzzy fallback."
},
"cursor": {
"type": "string"
},
"offset": {
"type": "number",
"description": "Skip N rows (default 0)"
},
"occupation": {
"type": "string",
"description": "Require this literal substring in the occupation field. Cannot combine with wealth_category."
},
"context_tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Require every exact context tag, case insensitive (for example [\"model\"]). Cannot combine with wealth_category."
},
"include_lists": {
"type": "boolean",
"description": "When true, each contact includes lists: [{ id, name, slug }]. Default false."
},
"include_notes": {
"type": "boolean",
"description": "When true, include notes (server-redacted). Default false."
},
"wealth_category": {
"enum": [
"reviewed"
],
"type": "string",
"description": "Only explicitly owner-reviewed wealth-category contacts. Returns id and name only; cannot combine with occupation or context_tags."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"to": {
"type": "string"
},
"tag": {
"type": "string",
"description": "Exact tag, e.g. project:max-soko-poker-venture or rail:zelle"
},
"from": {
"type": "string"
},
"type": {
"type": "string"
},
"limit": {
"type": "number",
"description": "Page size 1-500, default 100."
},
"cursor": {
"type": "string",
"description": "Continue the same immutable one-hour snapshot; other filters remain frozen."
},
"offset": {
"type": "number",
"description": "Skip this many rows of a new snapshot (a cursor carries its own)."
},
"project": {
"type": "string",
"description": "Project label or slug → project:{slug}"
},
"include_archived": {
"type": "boolean"
}
},
"additionalProperties": false
}| string |
| link_type | string | trip_stay | trip_flight | stay_place | event_place | event_person | transaction_trip | event_event | other. Aliases: participant/participants/attendee/attendees → event_person. |
| confidence | number | 0-1. Defaults to 1 for explicit links. 0 means rejected: every read leaves the edge out. |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"from_type",
"from_id",
"to_type",
"to_id"
],
"properties": {
"notes": {
"type": "string"
},
"to_id": {
"type": "string"
},
"source": {
"type": "string",
"description": "Provenance tag, e.g. manual, inferred:name_match:title."
},
"status": {
"enum": [
"confirmed",
"rejected"
],
"type": "string",
"description": "confirmed: confirm an existing edge (usually an inferred one: +confirmed, confidence 1), or create the edge if it does not exist yet, as a call without status does. rejected: tombstone an existing edge (+rejected, confidence 0). A rejected edge is not a relationship: the event's people, timelines, get_interactions and every other read leave it out. It is kept so automated writers never recreate it; linking the same pair again without status replaces it. Errors and saves nothing when the edge does not exist."
},
"from_id": {
"type": "string"
},
"to_type": {
"type": "string"
},
"from_type": {
"type": "string"
},
"link_type": {
"type": "string",
"description": "trip_stay | trip_flight | stay_place | event_place | event_person | transaction_trip | event_event | other. Aliases: participant/participants/attendee/attendees → event_person."
},
"confidence": {
"type": "number",
"description": "0-1. Defaults to 1 for explicit links. 0 means rejected: every read leaves the edge out."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"condition_id",
"subject_type"
],
"properties": {
"note": {
"type": "string"
},
"severity": {
"type": "integer",
"maximum": 10,
"minimum": 0,
"description": "0 (none) to 10 (worst)."
},
"logged_on": {
"type": "string",
"description": "YYYY-MM-DD; default today in the user's time zone."
},
"person_id": {
"type": "string",
"description": "Owned contact id; required for person."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"condition_id": {
"type": "string",
"description": "From get_conditions or create_condition."
},
"subject_type": {
"enum": [
"self",
"person"
],
"type": "string",
"description": "self, or person with person_id."
},
"treatment_done": {
"type": "string",
"description": "What they did for it that day."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| 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. |
| request_id | string | A new id (UUID) per write; send the same value again only to retry this exact call (the retry returns the first result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"text": {
"type": "string",
"description": "What the user had, bought or did, in their words (max 500). For food the item (\"kopi peng\"); for an expense what it was for."
},
"type": {
"enum": [
"food",
"meal",
"snack",
"drink",
"kopi",
"coffee",
"expense",
"moment"
],
"type": "string",
"description": "What kind of entry."
},
"when": {
"type": "string",
"description": "Optional ISO 8601 instant with offset when it happened. Leave out for now."
},
"place": {
"type": "string",
"description": "Optional place or merchant name."
},
"amount": {
"type": "number",
"description": "Price paid, a positive number. Required for type expense."
},
"category": {
"type": "string",
"description": "Optional Finance category, type expense only."
},
"currency": {
"type": "string",
"description": "3-letter currency of amount (e.g. SGD)."
},
"timezone": {
"type": "string",
"description": "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."
},
"request_id": {
"type": "string",
"description": "A new id (UUID) per write; send the same value again only to retry this exact call (the retry returns the first result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| Alias for description. |
| title* | string | Event title (required). |
| amount | number | If set, also writes a /money transaction (dual-write). Prefer log_transaction / import_venmo_gmail for cashflow-first digs. |
| people | array | People names or person UUIDs to tag (event_people role=with). |
| source | string | With amount: venmo/zelle/… |
| country | string | Structured country |
| category | string | e.g. sleep, funeral, family, work, travel. Stored as events.category and event_type. |
| currency | string |
| end_date | string | Optional end date YYYY-MM-DD (multi-day, or a night that ends the next day). |
| end_time | string | Optional end time (same formats as event_time). Works without event_time, e.g. a wake time alone. |
| location | string | Free-text place. Or pass city + country. |
| timezone | string | IANA timezone for wall-clock display (e.g. America/New_York). |
| direction | string | With amount: from=received, to=sent |
| image_url | string | Optional cover image URL for Explore + /e share cards. |
| person_id | string | With amount: CRM person UUID |
| event_date | string | Start date YYYY-MM-DD, YYYY-MM, or YYYY (required). Alias: date. For a task, its real due date; if the user gave none, ask. Don't use today. |
| event_time | string | Optional start time: 8pm, 20:00, or 20:00:00. Alias: time. Leave it out when nobody said it. |
| event_type | string | Optional event kind (e.g. todo, goal, work). Worked out from category when omitted. |
| person_ids | array | Owned person UUIDs to tag (user-scoped). |
| request_id | string | Alias for idempotency_key (preferred by some clients). |
| scoreboard | object | Operating status as data (not description prose). state is required when the event has no scoreboard yet. On update_event fields merge; a null field clears it; scoreboard null removes the record. |
| share_with | array | Dayze profile handles to add as collaborators via shared_events (e.g. ["boof"]). Leading @ stripped. |
| visibility | string | Calendar visibility. public → appears on /explore and gets share_url https://dayze.com/e/{id}. Default private. |
| description | string | Notes about the event. Alias: notes. |
| external_id | string | With amount: idempotency key |
| person_name | string | One person to tag, by name. |
| external_url | string |
| people_names | array | Alias for people. |
| date_precision | string | Soft date precision stored in metadata. YYYY/YYYY-MM dates default to year/month. |
| idempotency_key | string | Optional client key (max 128 chars). Retries with the same key return the original result instead of creating a duplicate. If omitted, Dayze fingerprints args for ~15 minutes. |
| source_gmail_id | string | Gmail message id the event came from (kept in metadata). |
| reminder_enabled | boolean | Timed events default to a push reminder when omitted, except a start already in the past (default off). Pass false for log / past-tense entries and any explicit opt-out; all-day events stay off. |
| mirror_transaction | boolean | Default true when amount is set; set false to keep calendar-only |
| reminder_minutes_before | number | Push lead time. Uses the profile reminder_timing when omitted (fallback 30 minutes). |
| source_email_participants | array | Sender/To/Cc identities from source_gmail_id. Contacts are proposed only on one exact stored email match; shared/unknown/automated addresses stay unresolved. Do not also pass people fields. |
{
"type": "object",
"anyOf": [
{
"required": [
"event_date"
]
},
{
"required": [
"date"
]
}
],
"required": [
"title"
],
"properties": {
"city": {
"type": "string",
"description": "Structured city (composed into location if location omitted)"
},
"date": {
"type": "string",
"description": "Alias for event_date."
},
"time": {
"type": "string",
"description": "Alias for event_time."
},
"with": {
"type": "array",
"items": {
"type": "string"
},
"description": "Alias for people."
},
"notes": {
"type": "string",
"description": "Alias for description."
},
"title": {
"type": "string",
"description": "Event title (required)."
},
"amount": {
"type": "number",
"description": "If set, also writes a /money transaction (dual-write). Prefer log_transaction / import_venmo_gmail for cashflow-first digs."
},
"people": {
"type": "array",
"items": {
"type": "string"
},
"description": "People names or person UUIDs to tag (event_people role=with)."
},
"source": {
"type": "string",
"description": "With amount: venmo/zelle/…"
},
"country": {
"type": "string",
"description": "Structured country"
},
"category": {
"type": "string",
"description": "e.g. sleep, funeral, family, work, travel. Stored as events.category and event_type."
},
"currency": {
"type": "string"
},
"end_date": {
"type": "string",
"description": "Optional end date YYYY-MM-DD (multi-day, or a night that ends the next day)."
},
"end_time": {
"type": "string",
"description": "Optional end time (same formats as event_time). Works without event_time, e.g. a wake time alone."
},
"location": {
"type": "string",
"description": "Free-text place. Or pass city + country."
},
"timezone": {
"type": "string",
"description": "IANA timezone for wall-clock display (e.g. America/New_York)."
},
"direction": {
"enum": [
"from",
"to"
],
"type": "string",
"description": "With amount: from=received, to=sent"
},
"image_url": {
"type": "string",
"description": "Optional cover image URL for Explore + /e share cards."
},
"person_id": {
"type": "string",
"description": "With amount: CRM person UUID"
},
"event_date": {
"type": "string",
"description": "Start date YYYY-MM-DD, YYYY-MM, or YYYY (required). Alias: date. For a task, its real due date; if the user gave none, ask. Don't use today."
},
"event_time": {
"type": "string",
"description": "Optional start time: 8pm, 20:00, or 20:00:00. Alias: time. Leave it out when nobody said it."
},
"event_type": {
"type": "string",
"description": "Optional event kind (e.g. todo, goal, work). Worked out from category when omitted."
},
"person_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Owned person UUIDs to tag (user-scoped)."
},
"request_id": {
"type": "string",
"description": "Alias for idempotency_key (preferred by some clients)."
},
"scoreboard": {
"type": "object",
"properties": {
"owner": {
"type": "string"
},
"state": {
"enum": [
"not_started",
"on_track",
"at_risk",
"blocked",
"done"
],
"type": "string"
},
"metric": {
"type": "string",
"description": "Progress readout, e.g. 2/5"
},
"blocker": {
"type": "string"
},
"evidence": {
"type": "string"
},
"next_step": {
"type": "string"
},
"next_review": {
"type": "string",
"description": "YYYY-MM-DD"
},
"last_verified": {
"type": "string",
"description": "YYYY-MM-DD"
}
},
"description": "Operating status as data (not description prose). state is required when the event has no scoreboard yet. On update_event fields merge; a null field clears it; scoreboard null removes the record.",
"additionalProperties": false
},
"share_with": {
"type": "array",
"items": {
"type": "string"
},
"description": "Dayze profile handles to add as collaborators via shared_events (e.g. [\"boof\"]). Leading @ stripped."
},
"visibility": {
"enum": [
"private",
"friends",
"public"
],
"type": "string",
"default": "private",
"description": "Calendar visibility. public → appears on /explore and gets share_url https://dayze.com/e/{id}. Default private."
},
"description": {
"type": "string",
"description": "Notes about the event. Alias: notes."
},
"external_id": {
"type": "string",
"description": "With amount: idempotency key"
},
"person_name": {
"type": "string",
"description": "One person to tag, by name."
},
"external_url": {
"type": "string"
},
"people_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Alias for people."
},
"date_precision": {
"enum": [
"day",
"month",
"year",
"approx"
],
"type": "string",
"description": "Soft date precision stored in metadata. YYYY/YYYY-MM dates default to year/month."
},
"idempotency_key": {
"type": "string",
"description": "Optional client key (max 128 chars). Retries with the same key return the original result instead of creating a duplicate. If omitted, Dayze fingerprints args for ~15 minutes."
},
"source_gmail_id": {
"type": "string",
"description": "Gmail message id the event came from (kept in metadata)."
},
"reminder_enabled": {
"type": "boolean",
"description": "Timed events default to a push reminder when omitted, except a start already in the past (default off). Pass false for log / past-tense entries and any explicit opt-out; all-day events stay off."
},
"mirror_transaction": {
"type": "boolean",
"description": "Default true when amount is set; set false to keep calendar-only"
},
"reminder_minutes_before": {
"type": "number",
"description": "Push lead time. Uses the profile reminder_timing when omitted (fallback 30 minutes)."
},
"source_email_participants": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string"
},
"role": {
"enum": [
"sender",
"to",
"cc",
"participant"
],
"type": "string"
},
"email": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 50,
"description": "Sender/To/Cc identities from source_gmail_id. Contacts are proposed only on one exact stored email match; shared/unknown/automated addresses stay unresolved. Do not also pass people fields."
}
},
"additionalProperties": false
}| merchant | string | Payee name (defaults when omitted) |
| person_id | string | The contact paid (needed for "IOU repayment" / "IOU lend"). |
| cash_moved | boolean | With category "IOU lend": true (default) = cash changed hands as a loan (shows in Finance); false = an owed share, e.g. of a dinner logged as its own expense (IOU only). Ignored for iou_type invoice. |
| request_id | string | Client idempotency key (retries return original result). |
| description | string | Alias for notes. |
| external_id | string | The provider's id for this payment; dedupes imports. Without a request_id it is required. |
| person_name | string | The contact by name, when there is no person_id (IOU categories need one or the other). |
| client_label | string | Optional free-text client label for an invoice IOU. |
| payment_method | string | Alias for source. |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"amount"
],
"properties": {
"date": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional tags. Prefer project: / ext: / rail: grammar."
},
"notes": {
"type": "string",
"description": "Free text about the payment. Alias: description."
},
"amount": {
"type": "number"
},
"source": {
"type": "string",
"description": "Payment rail or app: venmo, zelle, cashapp, card, cash, … Alias: payment_method."
},
"project": {
"type": "string",
"description": "Venture/project label → stored as project:{slug} tag (e.g. Max Soko poker venture)"
},
"category": {
"type": "string",
"description": "\"IOU repayment\" = paying a contact back; \"IOU lend\" = lending a contact cash (both need person_id)."
},
"currency": {
"type": "string"
},
"iou_type": {
"type": "string",
"description": "loan (default) or invoice. Invoice = unpaid receivable: no Finance outflow on create; payment is income \"Invoice payment\". Use for invoice/receivable phrasings; \"I lent…\" → loan."
},
"merchant": {
"type": "string",
"description": "Payee name (defaults when omitted)"
},
"person_id": {
"type": "string",
"description": "The contact paid (needed for \"IOU repayment\" / \"IOU lend\")."
},
"cash_moved": {
"type": "boolean",
"description": "With category \"IOU lend\": true (default) = cash changed hands as a loan (shows in Finance); false = an owed share, e.g. of a dinner logged as its own expense (IOU only). Ignored for iou_type invoice."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"description": {
"type": "string",
"description": "Alias for notes."
},
"external_id": {
"type": "string",
"description": "The provider's id for this payment; dedupes imports. Without a request_id it is required."
},
"person_name": {
"type": "string",
"description": "The contact by name, when there is no person_id (IOU categories need one or the other)."
},
"client_label": {
"type": "string",
"description": "Optional free-text client label for an invoice IOU."
},
"payment_method": {
"type": "string",
"description": "Alias for source."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| remaster_note | string | Alias for year_note |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Alias for source_url"
},
"title": {
"type": "string",
"description": "Track title (required unless track blob parses)"
},
"track": {
"type": "string",
"description": "Optional \"Artist - Title (year remaster)\" blob"
},
"artist": {
"type": "string",
"description": "Artist name (required unless track blob parses)"
},
"person_id": {
"type": "string",
"description": "Optional owned contact id from get_people; the track appears on that contact profile and shared history"
},
"year_note": {
"type": "string",
"description": "Optional year or remaster note"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"source_url": {
"type": "string",
"description": "Optional https link"
},
"remaster_note": {
"type": "string",
"description": "Alias for year_note"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| calories | number | Kilocalories explicitly stated by the user; overrides the automatic heuristic and is stored with user provenance |
| currency | string | ISO currency, e.g. SGD |
| merchant | string | Restaurant, stall, or shop |
| dish_items | array | Ordered dishes in this entry. Each requires name; price and rating are optional. |
| expense_id | string | Link this entry to ONE existing Finance transaction you own (UUID from get_expenses / log_expense) instead of recording a new one |
| person_ids | array | Owned person UUIDs to tag (user-scoped) |
| request_id | string | Client idempotency key (retries return original result). |
| consumed_at | string | ISO instant; wins over meal_period |
| meal_period | string | Spoken period when consumed_at is omitted, e.g. "late lunch" |
| people_names | array | Alias for with |
| payment_method | string | How it was paid (cash, card, PayLah, PayNow…). Saved on the Finance transaction; never the payer |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"what"
],
"properties": {
"kind": {
"enum": [
"meal",
"snack",
"drink"
],
"type": "string"
},
"what": {
"type": "string",
"description": "What they ate or drank (required). Example: Mee Pok"
},
"with": {
"type": "array",
"items": {
"type": "string"
},
"description": "Companion names, aliases, ids, or group tokens. \"my parents\" / Mum / Dad resolve via aliases; \"family\" expands to CRM rows with family relationship labels"
},
"notes": {
"type": "string"
},
"place": {
"type": "string",
"description": "Venue or location"
},
"amount": {
"type": "number",
"description": "Price if mentioned"
},
"paid_by": {
"type": "string",
"description": "Who paid. A person's name or alias for a third party; \"self\" / \"me\" = the user paid (recorded in Finance); \"unknown\" = payer not known. Not a payment method: use payment_method"
},
"calories": {
"type": "number",
"maximum": 10000,
"minimum": 0,
"description": "Kilocalories explicitly stated by the user; overrides the automatic heuristic and is stored with user provenance"
},
"currency": {
"type": "string",
"description": "ISO currency, e.g. SGD"
},
"merchant": {
"type": "string",
"description": "Restaurant, stall, or shop"
},
"dish_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"price": {
"type": "number",
"minimum": 0
},
"rating": {
"type": "number",
"maximum": 5,
"minimum": 1
}
},
"additionalProperties": false
},
"description": "Ordered dishes in this entry. Each requires name; price and rating are optional."
},
"expense_id": {
"type": "string",
"description": "Link this entry to ONE existing Finance transaction you own (UUID from get_expenses / log_expense) instead of recording a new one"
},
"person_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Owned person UUIDs to tag (user-scoped)"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"consumed_at": {
"type": "string",
"description": "ISO instant; wins over meal_period"
},
"meal_period": {
"type": "string",
"description": "Spoken period when consumed_at is omitted, e.g. \"late lunch\""
},
"people_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Alias for with"
},
"payment_method": {
"type": "string",
"description": "How it was paid (cash, card, PayLah, PayNow…). Saved on the Finance transaction; never the payer"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| merchant | string |
| person_id | string |
| cash_moved | boolean | With category "IOU lend": true (default) = cash changed hands as a loan (shows in Finance); false = an owed share, e.g. of a dinner logged as its own expense (IOU only). Ignored for iou_type invoice. |
| request_id | string | Client idempotency key (retries return original result). |
| description | string | Alias for notes. |
| external_id | string |
| person_name | string | The contact by name, when there is no person_id (IOU categories need one or the other). |
| client_label | string | Optional free-text client label for an invoice IOU. |
| payment_method | string |
| idempotency_key | string | Alias for request_id. |
| not_iou_repayment | boolean | true only when income from a contact with an open IOU is unrelated to it. |
{
"type": "object",
"required": [
"amount"
],
"properties": {
"date": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional tags. Prefer project: / ext: / rail: grammar."
},
"notes": {
"type": "string",
"description": "Free text about the payment. Alias: description."
},
"amount": {
"type": "number"
},
"source": {
"type": "string"
},
"project": {
"type": "string",
"description": "Venture/project label → stored as project:{slug} tag (e.g. Max Soko poker venture)"
},
"category": {
"type": "string",
"description": "e.g. Salary, Gift, Refund. \"IOU repayment\" and \"IOU lend\" need person_id."
},
"currency": {
"type": "string"
},
"iou_type": {
"type": "string",
"description": "loan (default) or invoice. Invoice = unpaid receivable: no Finance outflow on create; payment is income \"Invoice payment\". Use for invoice/receivable phrasings; \"I lent…\" → loan."
},
"merchant": {
"type": "string"
},
"person_id": {
"type": "string"
},
"cash_moved": {
"type": "boolean",
"description": "With category \"IOU lend\": true (default) = cash changed hands as a loan (shows in Finance); false = an owed share, e.g. of a dinner logged as its own expense (IOU only). Ignored for iou_type invoice."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"description": {
"type": "string",
"description": "Alias for notes."
},
"external_id": {
"type": "string"
},
"person_name": {
"type": "string",
"description": "The contact by name, when there is no person_id (IOU categories need one or the other)."
},
"client_label": {
"type": "string",
"description": "Optional free-text client label for an invoice IOU."
},
"payment_method": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"not_iou_repayment": {
"type": "boolean",
"description": "true only when income from a contact with an open IOU is unrelated to it."
}
},
"additionalProperties": false
}| idempotency_key |
| string |
| Alias for request_id. |
{
"type": "object",
"properties": {
"kind": {
"enum": [
"message",
"call",
"meeting",
"note",
"check_in",
"thought_of"
],
"type": "string",
"description": "Default message."
},
"summary": {
"type": "string",
"description": "One line (max 280) in your own words. Never the email body, subject or sender."
},
"reply_id": {
"type": "string",
"description": "A Pending Reply (get_pending_replies) this closes as sent."
},
"person_id": {
"type": "string",
"description": "An owned contact id."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"occurred_at": {
"type": "string",
"description": "When it happened (ISO date-time). Default now."
},
"person_name": {
"type": "string",
"description": "The contact as the user said it (\"Vadim\"); linked only on one match."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| string |
| Alias for location_name. |
| media_urls | array | Optional https image links (max 10). |
| person_ids | array | Owned contact ids of people in the story (max 25). An id that isn't the user's saves nothing. |
| request_id | string | Client idempotency key (retries return original result). |
| description | string | The longer story, in the user's words where possible. |
| moment_date | string | When it happened: YYYY-MM-DD, YYYY-MM or YYYY (alias date). With event_id and no date, the event's date is used. Otherwise required. |
| moment_time | string | Optional local time-of-day when it happened (HH:mm or HH:mm:ss). Null/empty = date-only. Not the row created_at. |
| moment_type | string | Default memory. |
| people_names | array | Names the user said; tagged only when they match a saved contact (never created). Unmatched names come back in unresolved_people. |
| location_name | string | Where it happened, only as the user said it. With event_id and no place, the event's location is used. Alias: location. |
| cover_image_url | string | Optional https image link for the moment's cover. |
| idempotency_key | string | Alias for request_id. |
| moment_date_precision | string | How exact the date is. YYYY-MM and YYYY default to month and year; circa for "around then". |
{
"type": "object",
"required": [
"title"
],
"properties": {
"date": {
"type": "string",
"description": "Alias for moment_date."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional short tags (max 20, 40 characters each)."
},
"title": {
"type": "string",
"description": "The story in a few words (max 200), e.g. \"Mia called the moon a banana\"."
},
"end_date": {
"type": "string",
"description": "Optional last day YYYY-MM-DD, for a moment that spans days."
},
"event_id": {
"type": "string",
"description": "A calendar event this story is about (owned). Links the new moment to it; the event is not changed."
},
"location": {
"type": "string",
"description": "Alias for location_name."
},
"media_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional https image links (max 10)."
},
"person_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Owned contact ids of people in the story (max 25). An id that isn't the user's saves nothing."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"description": {
"type": "string",
"description": "The longer story, in the user's words where possible."
},
"moment_date": {
"type": "string",
"description": "When it happened: YYYY-MM-DD, YYYY-MM or YYYY (alias date). With event_id and no date, the event's date is used. Otherwise required."
},
"moment_time": {
"type": "string",
"description": "Optional local time-of-day when it happened (HH:mm or HH:mm:ss). Null/empty = date-only. Not the row created_at."
},
"moment_type": {
"enum": [
"first_met",
"milestone",
"trip",
"achievement",
"memory",
"anniversary",
"life_event",
"relationship",
"career",
"health",
"creative",
"loss",
"other"
],
"type": "string",
"description": "Default memory."
},
"people_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Names the user said; tagged only when they match a saved contact (never created). Unmatched names come back in unresolved_people."
},
"location_name": {
"type": "string",
"description": "Where it happened, only as the user said it. With event_id and no place, the event's location is used. Alias: location."
},
"cover_image_url": {
"type": "string",
"description": "Optional https image link for the moment's cover."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"moment_date_precision": {
"enum": [
"exact",
"month",
"year",
"circa"
],
"type": "string",
"description": "How exact the date is. YYYY-MM and YYYY default to month and year; circa for \"around then\"."
}
},
"additionalProperties": false
}| string |
| external_id* | string |
| origin_city | string |
| origin_address | string |
| origin_country | string |
| route_geometry | object |
| distance_meters | number |
| geometry_source | string |
| idempotency_key | string | Alias for request_id. |
| destination_city | string |
| duration_seconds | number |
| source_reference | string |
| destination_address | string |
| destination_country | string |
{
"type": "object",
"required": [
"origin",
"destination",
"departed_at",
"arrived_at",
"mode",
"source",
"external_id"
],
"properties": {
"mode": {
"enum": [
"walk",
"bike",
"car",
"rideshare",
"train",
"bus",
"ferry",
"flight",
"other"
],
"type": "string"
},
"origin": {
"type": "string"
},
"source": {
"type": "string"
},
"metadata": {
"type": "object"
},
"provider": {
"type": "string"
},
"arrived_at": {
"type": "string"
},
"confidence": {
"type": "number"
},
"expense_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"departed_at": {
"type": "string"
},
"destination": {
"type": "string"
},
"external_id": {
"type": "string"
},
"origin_city": {
"type": "string"
},
"origin_address": {
"type": "string"
},
"origin_country": {
"type": "string"
},
"route_geometry": {
"type": "object"
},
"distance_meters": {
"type": "number"
},
"geometry_source": {
"enum": [
"observed_gps",
"provider_polyline",
"reconstructed",
"straight_line"
],
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"destination_city": {
"type": "string"
},
"duration_seconds": {
"type": "number"
},
"source_reference": {
"type": "string"
},
"destination_address": {
"type": "string"
},
"destination_country": {
"type": "string"
}
},
"additionalProperties": false
}| string |
| arrived_at | string | ISO 8601 with offset (2026-10-21T15:00:00+08:00) when the user gave a time or part of day (morning 09:00, afternoon 15:00, evening 19:00, local); a clock time without an offset is wall time in the account timezone; YYYY-MM-DD when only the day is known (time not specified). |
| confidence | number |
| request_id | string | Client idempotency key (retries return original result). |
| departed_at | string |
| idempotency_key | string | Alias for request_id. |
| evidence_event_id | string |
| evidence_expense_id | string |
| arrival_time_precision | string | approximate when arrived_at reads a part of day the user gave (morning, afternoon, evening → 09:00/15:00/19:00); exact (default) when the user gave the clock time. Ignored for a date-only arrival. |
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"date": {
"type": "string",
"description": "Alias for arrived_at (YYYY-MM-DD: the day only, time not specified)"
},
"name": {
"type": "string",
"description": "Alias for place"
},
"place": {
"type": "string"
},
"source": {
"type": "string",
"description": "Provenance tag (uber, mcp, manual, import, gmail:uber-<id>), not a note."
},
"address": {
"type": "string"
},
"country": {
"type": "string"
},
"place_id": {
"type": "string"
},
"arrived_at": {
"type": "string",
"description": "ISO 8601 with offset (2026-10-21T15:00:00+08:00) when the user gave a time or part of day (morning 09:00, afternoon 15:00, evening 19:00, local); a clock time without an offset is wall time in the account timezone; YYYY-MM-DD when only the day is known (time not specified)."
},
"confidence": {
"type": "number"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"departed_at": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"evidence_event_id": {
"type": "string"
},
"evidence_expense_id": {
"type": "string"
},
"arrival_time_precision": {
"enum": [
"exact",
"approximate"
],
"type": "string",
"description": "approximate when arrived_at reads a part of day the user gave (morning, afternoon, evening → 09:00/15:00/19:00); exact (default) when the user gave the clock time. Ignored for a date-only arrival."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"started_at",
"ended_at"
],
"properties": {
"notes": {
"type": "string"
},
"source": {
"type": "string"
},
"quality": {
"type": "number"
},
"ended_at": {
"type": "string",
"description": "ISO end"
},
"timezone": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"sleep_type": {
"enum": [
"overnight",
"nap",
"unknown"
],
"type": "string"
},
"started_at": {
"type": "string",
"description": "ISO start"
},
"timezone_end": {
"type": "string"
},
"timezone_start": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| category | string | Ledger category (e.g. Salary, Gift, Refund, Transfer in, Food & Dining). "IOU repayment" = a contact paying back a loan IOU; "IOU lend" = a cash loan; "Invoice payment" = collecting an unpaid invoice (need person_id). |
| currency | string |
| iou_type | string | loan (default) or invoice. Invoice = unpaid receivable: no Finance outflow on create; payment is income "Invoice payment". Use for invoice/receivable phrasings; "I lent…" → loan. |
| merchant | string |
| direction* | string |
| person_id | string |
| account_id | string | Stable provider account identity for imported payments. |
| cash_moved | boolean | With category "IOU lend": true (default) = cash changed hands as a loan (shows in Finance); false = an owed share, e.g. of a dinner logged as its own expense (IOU only). Ignored for iou_type invoice. |
| message_id | string |
| request_id | string | Client idempotency key (retries return original result). |
| description | string | Alias for notes. |
| external_id | string |
| person_name | string | The contact by name, when there is no person_id (IOU categories need one or the other). |
| client_label | string | Optional free-text client label for an invoice IOU. |
| mirror_event | boolean | Also insert optional Money · calendar event (default false) |
| payment_method | string |
| idempotency_key | string | Alias for request_id. |
| extractor_version | string |
| not_iou_repayment | boolean | true only when income from a contact with an open IOU is unrelated to it. |
{
"type": "object",
"required": [
"amount",
"direction"
],
"properties": {
"date": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional tags. Prefer project: / ext: / rail: grammar."
},
"type": {
"enum": [
"income",
"expense",
"transfer"
],
"type": "string"
},
"notes": {
"type": "string",
"description": "Free text about the payment. Alias: description."
},
"amount": {
"type": "number"
},
"source": {
"type": "string"
},
"project": {
"type": "string",
"description": "Venture/project label → stored as project:{slug} tag (e.g. Max Soko poker venture)"
},
"category": {
"type": "string",
"description": "Ledger category (e.g. Salary, Gift, Refund, Transfer in, Food & Dining). \"IOU repayment\" = a contact paying back a loan IOU; \"IOU lend\" = a cash loan; \"Invoice payment\" = collecting an unpaid invoice (need person_id)."
},
"currency": {
"type": "string"
},
"iou_type": {
"type": "string",
"description": "loan (default) or invoice. Invoice = unpaid receivable: no Finance outflow on create; payment is income \"Invoice payment\". Use for invoice/receivable phrasings; \"I lent…\" → loan."
},
"merchant": {
"type": "string"
},
"direction": {
"enum": [
"from",
"to"
],
"type": "string"
},
"person_id": {
"type": "string"
},
"account_id": {
"type": "string",
"description": "Stable provider account identity for imported payments."
},
"cash_moved": {
"type": "boolean",
"description": "With category \"IOU lend\": true (default) = cash changed hands as a loan (shows in Finance); false = an owed share, e.g. of a dinner logged as its own expense (IOU only). Ignored for iou_type invoice."
},
"message_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"description": {
"type": "string",
"description": "Alias for notes."
},
"external_id": {
"type": "string"
},
"person_name": {
"type": "string",
"description": "The contact by name, when there is no person_id (IOU categories need one or the other)."
},
"client_label": {
"type": "string",
"description": "Optional free-text client label for an invoice IOU."
},
"mirror_event": {
"type": "boolean",
"description": "Also insert optional Money · calendar event (default false)"
},
"payment_method": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"extractor_version": {
"type": "string"
},
"not_iou_repayment": {
"type": "boolean",
"description": "true only when income from a contact with an open IOU is unrelated to it."
}
},
"additionalProperties": false
}| string |
| YYYY-MM-DD |
| mirror_event | boolean | Also insert category=travel calendar event (default true) |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"city"
],
"properties": {
"city": {
"type": "string"
},
"date": {
"type": "string",
"description": "Alias for start_date"
},
"kind": {
"enum": [
"trip",
"residence",
"soft_pin"
],
"type": "string"
},
"title": {
"type": "string"
},
"country": {
"type": "string"
},
"end_date": {
"type": "string"
},
"evidence": {
"type": "string",
"description": "Source note (Gmail id, address, etc.)"
},
"confidence": {
"enum": [
"confirmed",
"likely",
"possible"
],
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"start_date": {
"type": "string",
"description": "YYYY-MM-DD"
},
"mirror_event": {
"type": "boolean",
"description": "Also insert category=travel calendar event (default true)"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"canonical_memory_id": {
"type": "string",
"description": "Surviving memory id, checked against the preview."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"canonical_id",
"retired_ids",
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"retired_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"canonical_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}| string |
| When it applied, as an ISO timestamp. |
| condition_id | string | From get_conditions or create_condition. |
| subject_type* | string | self, or person with person_id. |
| supersedes_id | string | The effective trend point this correction replaces. |
| idempotency_key | string | Alias for request_id. |
| correction_reason | string | Required with supersedes_id; what was wrong with the prior point. |
{
"type": "object",
"required": [
"kind",
"metric",
"observed_at",
"value",
"confidence",
"source",
"subject_type"
],
"properties": {
"kind": {
"enum": [
"symptom",
"treatment",
"energy",
"sleep"
],
"type": "string"
},
"unit": {
"type": "string",
"description": "Optional scale/unit, e.g. 0-10, boolean, 1-5, minutes."
},
"value": {
"type": [
"number",
"string",
"boolean"
],
"description": "A scalar value. Put its scale or measurement in unit."
},
"metric": {
"type": "string",
"description": "What was measured, e.g. severity, completed, energy or duration_minutes."
},
"source": {
"type": "string",
"description": "Provenance, e.g. user_reported, condition_checkin, daily_checkin or sleep_record."
},
"person_id": {
"type": "string",
"description": "Owned contact id; required for person."
},
"confidence": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"observed_at": {
"type": "string",
"description": "When it applied, as an ISO timestamp."
},
"condition_id": {
"type": "string",
"description": "From get_conditions or create_condition."
},
"subject_type": {
"enum": [
"self",
"person"
],
"type": "string",
"description": "self, or person with person_id."
},
"supersedes_id": {
"type": "string",
"description": "The effective trend point this correction replaces."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"correction_reason": {
"type": "string",
"description": "Required with supersedes_id; what was wrong with the prior point."
}
},
"additionalProperties": false
}| object |
| The Inventory item: category, brand, model, condition, notes. |
{
"type": "object",
"required": [
"name",
"amount"
],
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD; default today."
},
"name": {
"type": "string",
"description": "What was bought (also the Inventory item name). Alias: merchant."
},
"amount": {
"type": "number"
},
"category": {
"type": "string",
"description": "Expense category (default purchase); also the item category when inventory_details has none."
},
"currency": {
"type": "string",
"description": "ISO 4217; default USD."
},
"merchant": {
"type": "string",
"description": "Where it was bought; stands in for name when name is missing."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"create_inventory": {
"type": "boolean",
"description": "false = the expense only, no Inventory item (default true)."
},
"inventory_details": {
"type": "object",
"properties": {
"brand": {
"type": "string"
},
"model": {
"type": "string"
},
"notes": {
"type": "string"
},
"category": {
"type": "string"
},
"condition": {
"enum": [
"new",
"excellent",
"good",
"worn",
"needs_repair",
"retired"
],
"type": "string"
}
},
"description": "The Inventory item: category, brand, model, condition, notes.",
"additionalProperties": false
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"person_id",
"alias",
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"alias": {
"type": "string"
},
"person_id": {
"type": "string"
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}| string |
| Event UUID of the tracker |
| tracker_title | string | Title match when id unknown |
| idempotency_key | string | Alias for request_id. |
| restore_window_acknowledged* | boolean | Must be true after reviewing the preview and its 30-day restore window. |
{
"type": "object",
"required": [
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"note": {
"type": "string",
"description": "Optional note stored in tracking history"
},
"title": {
"type": "string",
"description": "Alias of tracker_title"
},
"reset_at": {
"type": "string",
"description": "ISO datetime of the reset (default now)"
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"tracker_id": {
"type": "string",
"description": "Event UUID of the tracker"
},
"tracker_title": {
"type": "string",
"description": "Title match when id unknown"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}| start |
| string |
| Alias for from. |
| entity_type | string | Route a Moment query to search_moments. |
{
"type": "object",
"anyOf": [
{
"required": [
"query"
]
},
{
"required": [
"q"
]
}
],
"properties": {
"q": {
"type": "string",
"description": "Alias for query."
},
"to": {
"type": "string",
"description": "Inclusive account-local YYYY-MM-DD upper bound for all search routes. May be used alone."
},
"end": {
"type": "string",
"description": "Alias for to."
},
"from": {
"type": "string",
"description": "Inclusive account-local YYYY-MM-DD lower bound for all search routes. May be used alone."
},
"limit": {
"type": "number",
"default": 10,
"description": "Max results 1–50"
},
"query": {
"type": "string",
"description": "Primary search query."
},
"start": {
"type": "string",
"description": "Alias for from."
},
"entity_type": {
"enum": [
"moment"
],
"type": "string",
"description": "Route a Moment query to search_moments."
}
},
"additionalProperties": false
}| before |
| string |
| Exclusive upper bound as account-local YYYY-MM-DDTHH:mm, or an offset-aware ISO instant |
| account | string | Mailbox email, connection id, or Google subject (from list_gmail_accounts) |
| max_results | number | Max messages to return (default 10, max 20) |
{
"type": "object",
"required": [
"query"
],
"properties": {
"q": {
"type": "string",
"description": "Alias for query"
},
"after": {
"type": "string",
"description": "Exclusive lower bound as account-local YYYY-MM-DDTHH:mm, or an offset-aware ISO instant"
},
"email": {
"type": "string",
"description": "Alias for account"
},
"query": {
"type": "string",
"description": "Gmail search query, e.g. \"is:unread newer_than:7d\", \"from:airline subject:itinerary\", \"receipt newer_than:30d\""
},
"before": {
"type": "string",
"description": "Exclusive upper bound as account-local YYYY-MM-DDTHH:mm, or an offset-aware ISO instant"
},
"account": {
"type": "string",
"description": "Mailbox email, connection id, or Google subject (from list_gmail_accounts)"
},
"max_results": {
"type": "number",
"default": 10,
"description": "Max messages to return (default 10, max 20)"
}
},
"additionalProperties": false
}| account_id |
| string |
| Optional. Update this person_accounts row instead of upserting by key. |
| is_primary | boolean | At most one primary per platform. Setting true unsets the previous primary. |
| request_id | string | Client idempotency key (retries return original result). |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"person_id",
"platform"
],
"properties": {
"url": {
"type": "string"
},
"kind": {
"type": "string",
"description": "personal | work | portfolio | other (default personal)"
},
"label": {
"type": "string",
"description": "Free-text note (e.g. photography). Required site name when platform=other."
},
"notes": {
"type": "string"
},
"handle": {
"type": "string"
},
"status": {
"type": "string",
"description": "likely | self_reported | unknown (verified is server-only)"
},
"platform": {
"type": "string",
"description": "dayze|chatgpt|claude|codex|cursor|gemini|instagram|facebook|linkedin|x|tiktok|youtube|github|threads|telegram|whatsapp|lawve|other"
},
"person_id": {
"type": "string"
},
"account_id": {
"type": "string",
"description": "Optional. Update this person_accounts row instead of upserting by key."
},
"is_primary": {
"type": "boolean",
"description": "At most one primary per platform. Setting true unsets the previous primary."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| Must be true after reviewing the preview and its 30-day restore window. |
{
"type": "object",
"required": [
"preview_id",
"restore_window_acknowledged",
"request_id"
],
"properties": {
"person_id": {
"type": "string"
},
"preview_id": {
"type": "string",
"description": "preview_id returned by preview_destructive_change for this tool."
},
"request_id": {
"type": "string",
"description": "Required idempotency key; retries return the original receipt."
},
"connection_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"other_person_id": {
"type": "string"
},
"restore_window_acknowledged": {
"type": "boolean",
"description": "Must be true after reviewing the preview and its 30-day restore window."
}
},
"additionalProperties": false
}| treatments | string | What they use or do for it. |
| condition_id* | string | From get_conditions or create_condition. |
| subject_type* | string | self, or person with person_id. |
| tracking_focus | string | What to watch on each check-in. |
| idempotency_key | string | Alias for request_id. |
| confirmation_status | string | unconfirmed | reported (default) | confirmed; never infer confirmed. |
{
"type": "object",
"required": [
"condition_id",
"subject_type"
],
"properties": {
"name": {
"type": "string",
"description": "What the user calls it, in their words (e.g. \"Blurry near vision\"). Never a diagnosis they did not give."
},
"notes": {
"type": "string"
},
"source": {
"type": "string",
"description": "Provenance, e.g. user_reported. Default user_reported."
},
"status": {
"enum": [
"suspected",
"active",
"improving",
"resolved"
],
"type": "string",
"description": "suspected (default for a new one) | active | improving | resolved."
},
"symptoms": {
"type": "string",
"description": "What they notice, e.g. \"Blurry at near distance, worse in the evening\"."
},
"body_area": {
"type": "string",
"description": "Where, e.g. \"Left eye\"."
},
"person_id": {
"type": "string",
"description": "Owned contact id; required for person."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"started_on": {
"type": "string",
"description": "YYYY-MM-DD it started (onset). Default for a new one: today."
},
"treatments": {
"type": "string",
"description": "What they use or do for it."
},
"condition_id": {
"type": "string",
"description": "From get_conditions or create_condition."
},
"subject_type": {
"enum": [
"self",
"person"
],
"type": "string",
"description": "self, or person with person_id."
},
"tracking_focus": {
"type": "string",
"description": "What to watch on each check-in."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"confirmation_status": {
"enum": [
"unconfirmed",
"reported",
"confirmed"
],
"type": "string",
"description": "unconfirmed | reported (default) | confirmed; never infer confirmed."
}
},
"additionalProperties": false
}| longitude |
| number |
| request_id | string |
| idempotency_key | string |
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"place": {
"type": "string",
"description": "Venue / residence name (e.g. The Madeira)"
},
"venue": {
"type": "string",
"description": "Alias for place"
},
"address": {
"type": "string"
},
"country": {
"type": "string"
},
"check_in": {
"type": "boolean",
"description": "Write a location_visits row when place or coordinates are set (default true in that case)"
},
"latitude": {
"type": "number"
},
"location": {
"type": "string",
"description": "Freeform “City, Country” or “Venue, City, Country”"
},
"set_home": {
"type": "boolean",
"description": "Also write profiles.location / home_location (default true)"
},
"longitude": {
"type": "number"
},
"request_id": {
"type": "string"
},
"idempotency_key": {
"type": "string"
}
},
"additionalProperties": false
}| end_date | string | Optional end date YYYY-MM-DD (multi-day, or a night that ends the next day). |
| end_time | string | Optional end time (same formats as event_time). |
| event_id* | string | UUID of a calendar event the authenticated user owns |
| location | string | Empty or null clears |
| timezone | string | IANA timezone for wall-clock display. Empty or null clears. |
| image_url | string | Cover image URL. Empty or null clears. |
| event_date | string | Start date YYYY-MM-DD, YYYY-MM, or YYYY. Alias: date. |
| event_time | string | Start time: 8pm, 20:00, or 20:00:00. Empty or null clears. Alias: time. |
| person_ids | array | Owned person UUIDs to tag (user-scoped). |
| request_id | string | Client idempotency key (retries return original successful result). |
| scoreboard | object | Operating status as data (not description prose). state is required when the event has no scoreboard yet. On update_event fields merge; a null field clears it; scoreboard null removes the record. |
| visibility | string | Updates both events.visibility and the enforced events.is_private flag. |
| description | string | Notes about the event (replaces). Empty or null clears. Alias: notes. |
| person_name | string | One person to tag, by name. |
| external_url | string |
| people_names | array | Alias for people. |
| date_precision | string | Soft date precision stored in metadata. |
| idempotency_key | string | Alias for request_id. |
| reminder_enabled | boolean | Turn the push reminder on or off. A timed event is needed to turn it on; all-day events stay off. |
| reminder_minutes_before | number | Push lead time in minutes (snapped to 0, 5, 15, 30, 60, 1440 or 10080). |
{
"type": "object",
"required": [
"event_id"
],
"properties": {
"date": {
"type": "string",
"description": "Alias for event_date."
},
"time": {
"type": "string",
"description": "Alias for event_time."
},
"with": {
"type": "array",
"items": {
"type": "string"
},
"description": "Alias for people."
},
"notes": {
"type": "string",
"description": "Alias for description."
},
"title": {
"type": "string",
"description": "Updated title (replaces). Cannot be empty."
},
"people": {
"type": "array",
"items": {
"type": "string"
},
"description": "People names or person UUIDs to add (event_people role=with). Does not remove existing tags."
},
"category": {
"type": "string",
"description": "e.g. sleep, funeral, family, work, travel. Stored as events.category and event_type."
},
"end_date": {
"type": "string",
"description": "Optional end date YYYY-MM-DD (multi-day, or a night that ends the next day)."
},
"end_time": {
"type": "string",
"description": "Optional end time (same formats as event_time)."
},
"event_id": {
"type": "string",
"description": "UUID of a calendar event the authenticated user owns"
},
"location": {
"type": "string",
"description": "Empty or null clears"
},
"timezone": {
"type": "string",
"description": "IANA timezone for wall-clock display. Empty or null clears."
},
"image_url": {
"type": "string",
"description": "Cover image URL. Empty or null clears."
},
"event_date": {
"type": "string",
"description": "Start date YYYY-MM-DD, YYYY-MM, or YYYY. Alias: date."
},
"event_time": {
"type": "string",
"description": "Start time: 8pm, 20:00, or 20:00:00. Empty or null clears. Alias: time."
},
"person_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Owned person UUIDs to tag (user-scoped)."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original successful result)."
},
"scoreboard": {
"type": "object",
"properties": {
"owner": {
"type": "string"
},
"state": {
"enum": [
"not_started",
"on_track",
"at_risk",
"blocked",
"done"
],
"type": "string"
},
"metric": {
"type": "string",
"description": "Progress readout, e.g. 2/5"
},
"blocker": {
"type": "string"
},
"evidence": {
"type": "string"
},
"next_step": {
"type": "string"
},
"next_review": {
"type": "string",
"description": "YYYY-MM-DD"
},
"last_verified": {
"type": "string",
"description": "YYYY-MM-DD"
}
},
"description": "Operating status as data (not description prose). state is required when the event has no scoreboard yet. On update_event fields merge; a null field clears it; scoreboard null removes the record.",
"additionalProperties": false
},
"visibility": {
"enum": [
"private",
"friends",
"public"
],
"type": "string",
"description": "Updates both events.visibility and the enforced events.is_private flag."
},
"description": {
"type": "string",
"description": "Notes about the event (replaces). Empty or null clears. Alias: notes."
},
"person_name": {
"type": "string",
"description": "One person to tag, by name."
},
"external_url": {
"type": "string"
},
"people_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Alias for people."
},
"date_precision": {
"enum": [
"day",
"month",
"year",
"approx"
],
"type": "string",
"description": "Soft date precision stored in metadata."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"reminder_enabled": {
"type": "boolean",
"description": "Turn the push reminder on or off. A timed event is needed to turn it on; all-day events stay off."
},
"reminder_minutes_before": {
"type": "number",
"description": "Push lead time in minutes (snapped to 0, 5, 15, 30, 60, 1440 or 10080)."
}
},
"additionalProperties": false
}| external_id | string | Optional; merges ext:{source}:{id} into tags |
| payment_method | string | e.g. venmo, cash, card |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"expense_id"
],
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD expense_date"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"notes": {
"type": "string"
},
"amount": {
"type": "number"
},
"source": {
"type": "string",
"description": "Alias of payment_method"
},
"project": {
"type": "string",
"description": "Venture label → project:{slug} tag"
},
"category": {
"type": "string"
},
"currency": {
"type": "string"
},
"merchant": {
"type": "string"
},
"expense_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"description": {
"type": "string"
},
"external_id": {
"type": "string",
"description": "Optional; merges ext:{source}:{id} into tags"
},
"payment_method": {
"type": "string",
"description": "e.g. venmo, cash, card"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| Venue or location. Empty or null clears |
| amount | number | Price if mentioned |
| dishes | array | Alias for dish_items. |
| people | array | Alias for with |
| food_id* | string | UUID of a food diary row the authenticated user owns |
| paid_by | string | Who paid. A person's name or alias for a third party; "self" / "me" = the user paid (recorded in Finance); "unknown" = payer not known. Empty or null clears. Not a payment method |
| calories | number | Correct the kcal value (0 is a real value). Stored as user-stated unless calories_source says agent_estimate. To clear it to unknown (not zero; totals skip it) send null, or calories_source "unknown" without calories. Omitted = unchanged, except that a corrected `what` re-derives an automatic estimate (never a user-stated value) |
| currency | string | ISO currency, e.g. SGD |
| merchant | string | Restaurant, stall, or shop. Empty or null clears |
| dish_items | array | Complete replacement ordered dish list; [] clears it. |
| expense_id | string | Link this entry to ONE existing Finance transaction you own (UUID), so the meal has one ledger row. Empty or null unlinks; the transaction stays in Finance |
| person_ids | array | Owned person UUIDs to tag (user-scoped) |
| request_id | string | Client idempotency key (retries return original result). |
| consumed_at | string | ISO instant; wins over meal_period |
| description | string | Alias for what (the dish, not notes). |
| meal_period | string | Spoken period when consumed_at is omitted, e.g. "late lunch" |
| person_name | string | One companion to add, by name |
| append_notes | string | Append text to existing notes (newline-separated) |
| people_names | array | Alias for with |
| payment_method | string | How it was paid (cash, card, PayLah…). Saved on the linked Finance transaction; never changes paid_by |
| calories_source | string | Provenance of calories: user (the user said it, default) or agent_estimate (your estimate). unknown (without calories) clears the kcal value |
| idempotency_key | string | Alias for request_id. |
| contains_alcohol | boolean | Correct whether the item contains alcohol (true for beer, wine, spirits, cocktails, an "alcoholic beverage") |
{
"type": "object",
"required": [
"food_id"
],
"properties": {
"food": {
"type": "string",
"description": "Alias for what."
},
"item": {
"type": "string",
"description": "Alias for what."
},
"kind": {
"enum": [
"meal",
"snack",
"drink"
],
"type": "string"
},
"what": {
"type": "string",
"description": "Full updated dish/drink text (replaces, does not append). Example: Salmon Bento + hot tea"
},
"with": {
"type": "array",
"items": {
"type": "string"
},
"description": "Companion names, aliases, or ids to add (does not remove existing tags)"
},
"notes": {
"type": "string",
"description": "Replaces notes. Empty or null clears"
},
"place": {
"type": "string",
"description": "Venue or location. Empty or null clears"
},
"amount": {
"type": "number",
"description": "Price if mentioned"
},
"dishes": {
"type": "array",
"description": "Alias for dish_items."
},
"people": {
"type": "array",
"items": {
"type": "string"
},
"description": "Alias for with"
},
"food_id": {
"type": "string",
"description": "UUID of a food diary row the authenticated user owns"
},
"paid_by": {
"type": "string",
"description": "Who paid. A person's name or alias for a third party; \"self\" / \"me\" = the user paid (recorded in Finance); \"unknown\" = payer not known. Empty or null clears. Not a payment method"
},
"calories": {
"type": "number",
"maximum": 10000,
"minimum": 0,
"description": "Correct the kcal value (0 is a real value). Stored as user-stated unless calories_source says agent_estimate. To clear it to unknown (not zero; totals skip it) send null, or calories_source \"unknown\" without calories. Omitted = unchanged, except that a corrected `what` re-derives an automatic estimate (never a user-stated value)"
},
"currency": {
"type": "string",
"description": "ISO currency, e.g. SGD"
},
"merchant": {
"type": "string",
"description": "Restaurant, stall, or shop. Empty or null clears"
},
"dish_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"price": {
"type": "number",
"minimum": 0
},
"rating": {
"type": "number",
"maximum": 5,
"minimum": 1
}
},
"additionalProperties": false
},
"description": "Complete replacement ordered dish list; [] clears it."
},
"expense_id": {
"type": "string",
"description": "Link this entry to ONE existing Finance transaction you own (UUID), so the meal has one ledger row. Empty or null unlinks; the transaction stays in Finance"
},
"person_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Owned person UUIDs to tag (user-scoped)"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"consumed_at": {
"type": "string",
"description": "ISO instant; wins over meal_period"
},
"description": {
"type": "string",
"description": "Alias for what (the dish, not notes)."
},
"meal_period": {
"type": "string",
"description": "Spoken period when consumed_at is omitted, e.g. \"late lunch\""
},
"person_name": {
"type": "string",
"description": "One companion to add, by name"
},
"append_notes": {
"type": "string",
"description": "Append text to existing notes (newline-separated)"
},
"people_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Alias for with"
},
"payment_method": {
"type": "string",
"description": "How it was paid (cash, card, PayLah…). Saved on the linked Finance transaction; never changes paid_by"
},
"calories_source": {
"enum": [
"user",
"agent_estimate",
"unknown"
],
"type": "string",
"description": "Provenance of calories: user (the user said it, default) or agent_estimate (your estimate). unknown (without calories) clears the kcal value"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"contains_alcohol": {
"type": "boolean",
"description": "Correct whether the item contains alcohol (true for beer, wine, spirits, cocktails, an \"alcoholic beverage\")"
}
},
"additionalProperties": false
}| state | object | Changing facts, as one observation: observed_at (ISO, default now), source (e.g. user_reported, system_profiler), confidence (0-1), and values such as os { name, version, build }, available_storage_bytes, battery, security { sip, gatekeeper, filevault }, services { bluebubbles: { installed_version, running, configured, blockers, checked_at } }. Merged per key; a key observed more recently is kept. Never changes specs or notes. Never device or account identifiers. |
| status | string | Default owned. To archive, use archive_inventory_item. |
| subtype | string | Specific kind: laptop, sweatshirt, guitar. Alias: item_type. |
| category | string | electronics | instruments | clothing | shoes | bags | accessories | jewelry | watches | collectibles | sports | health | home | tools | vehicles | furniture | other. Computers, phones and cameras are electronics; synths are instruments. Defaults to the spec_template's category, else other. |
| currency | string | ISO 4217, e.g. USD, SGD. Default USD. |
| location | string | Where it is kept. |
| nickname | string | In place of inventory_id: what the user calls the item ("MacBook", "work laptop"), matched to exactly one of their active items by nickname, name or model. Several matches are refused with the candidates. To rename it, set specs.nickname. |
| condition | string |
| item_type | string | Alias for subtype (the stored column). |
| request_id | string | Client idempotency key (retries return original result). |
| inventory_id | string | The item id from add_inventory_item, get_inventory or search_inventory. |
| acquired_date | string | YYYY-MM-DD it came into the user's life (gift, inheritance). add_inventory_item also stores it as purchase_date when none is given. |
| acquired_from | string | Shop or person it came from. |
| current_value | number | Alias for estimated_value (the stored column). |
| purchase_date | string | YYYY-MM-DD |
| spec_template | string | Which typed fields specs uses. Templates are listed in docs/MCP_LIFE_GRAPH.md. null (update) clears it. |
| purchase_price | number |
| estimated_value | number | What it is worth now. Alias: current_value. |
| idempotency_key | string | Alias for request_id. |
| acquisition_type | string | purchase | gift | inheritance | … |
| reference_number | string | Manufacturer reference or model number (e.g. a watch reference). |
| subtype_confidence | number | 0-1, when the subtype is a guess. |
| specs_schema_version | integer | Layout of specs and state. Only 1 (the default). |
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "What the user calls the item, e.g. \"MacBook Pro 14 (2023)\"."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replaces the tag list."
},
"brand": {
"type": "string"
},
"model": {
"type": "string"
},
"notes": {
"type": "string",
"description": "Free text from the user."
},
"specs": {
"type": "object",
"description": "Stable facts, by the template's field names (computer.v1: nickname, manufacturer, model_name, model_identifier, year, primary_uses, capability_tags, product_family, form_factor, chip, cpu, architecture, performance_cores, efficiency_cores, total_cores, threads, gpu, gpu_cores, gpu_memory_bytes, neural_engine_cores, memory_bytes, memory, storage_devices, display, ports). Merged per key on update; null removes a key; other keys are kept as written. Only what the user or the device says, never inferred from a model name. Never device or account identifiers."
},
"state": {
"type": "object",
"description": "Changing facts, as one observation: observed_at (ISO, default now), source (e.g. user_reported, system_profiler), confidence (0-1), and values such as os { name, version, build }, available_storage_bytes, battery, security { sip, gatekeeper, filevault }, services { bluebubbles: { installed_version, running, configured, blockers, checked_at } }. Merged per key; a key observed more recently is kept. Never changes specs or notes. Never device or account identifiers."
},
"status": {
"enum": [
"wishlist",
"ordered",
"owned",
"listed_for_sale",
"sold",
"returned",
"lost",
"disposed",
"donated"
],
"type": "string",
"description": "Default owned. To archive, use archive_inventory_item."
},
"subtype": {
"type": "string",
"description": "Specific kind: laptop, sweatshirt, guitar. Alias: item_type."
},
"category": {
"type": "string",
"description": "electronics | instruments | clothing | shoes | bags | accessories | jewelry | watches | collectibles | sports | health | home | tools | vehicles | furniture | other. Computers, phones and cameras are electronics; synths are instruments. Defaults to the spec_template's category, else other."
},
"currency": {
"type": "string",
"description": "ISO 4217, e.g. USD, SGD. Default USD."
},
"location": {
"type": "string",
"description": "Where it is kept."
},
"nickname": {
"type": "string",
"description": "In place of inventory_id: what the user calls the item (\"MacBook\", \"work laptop\"), matched to exactly one of their active items by nickname, name or model. Several matches are refused with the candidates. To rename it, set specs.nickname."
},
"condition": {
"enum": [
"new",
"excellent",
"good",
"worn",
"needs_repair",
"retired"
],
"type": "string"
},
"item_type": {
"type": "string",
"description": "Alias for subtype (the stored column)."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"inventory_id": {
"type": "string",
"description": "The item id from add_inventory_item, get_inventory or search_inventory."
},
"acquired_date": {
"type": "string",
"description": "YYYY-MM-DD it came into the user's life (gift, inheritance). add_inventory_item also stores it as purchase_date when none is given."
},
"acquired_from": {
"type": "string",
"description": "Shop or person it came from."
},
"current_value": {
"type": "number",
"description": "Alias for estimated_value (the stored column)."
},
"purchase_date": {
"type": "string",
"description": "YYYY-MM-DD"
},
"spec_template": {
"enum": [
"computer.v1",
"phone.v1",
"camera.v1",
"synth.v1"
],
"type": "string",
"description": "Which typed fields specs uses. Templates are listed in docs/MCP_LIFE_GRAPH.md. null (update) clears it."
},
"purchase_price": {
"type": "number"
},
"estimated_value": {
"type": "number",
"description": "What it is worth now. Alias: current_value."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"acquisition_type": {
"type": "string",
"description": "purchase | gift | inheritance | …"
},
"reference_number": {
"type": "string",
"description": "Manufacturer reference or model number (e.g. a watch reference)."
},
"subtype_confidence": {
"type": "number",
"description": "0-1, when the subtype is a guess."
},
"specs_schema_version": {
"type": "integer",
"description": "Layout of specs and state. Only 1 (the default)."
}
},
"additionalProperties": false
}| Replaces the image links. [] clears. |
| person_ids | array | Replaces the tagged people (with people_names). [] clears. Owned contact ids only. |
| request_id | string | Client idempotency key (retries return original result). |
| description | string | Replaces the story text. Empty or null clears. |
| moment_date | string | YYYY-MM-DD, YYYY-MM or YYYY (alias date). |
| moment_time | string | Optional local HH:mm or HH:mm:ss. Empty or null clears (date-only). |
| moment_type | string | Default memory. |
| people_names | array | Replaces the tagged people (with person_ids); names match saved contacts only. |
| location_name | string | Replaces the place. Empty or null clears. Alias: location. |
| cover_image_url | string | https image link. Empty or null clears. |
| idempotency_key | string | Alias for request_id. |
| moment_date_precision | string | How exact the date is. YYYY-MM and YYYY default to month and year; circa for "around then". |
{
"type": "object",
"required": [
"moment_id"
],
"properties": {
"date": {
"type": "string",
"description": "Alias for moment_date."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replaces the tags. [] clears."
},
"title": {
"type": "string",
"description": "New title (max 200). Cannot be empty."
},
"end_date": {
"type": "string",
"description": "YYYY-MM-DD. Empty or null clears."
},
"event_id": {
"type": "string",
"description": "Link the moment to an owned event (the event is not changed). Empty or null unlinks."
},
"location": {
"type": "string",
"description": "Alias for location_name."
},
"moment_id": {
"type": "string",
"description": "UUID of a moment the user owns (from log_moment)."
},
"media_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replaces the image links. [] clears."
},
"person_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replaces the tagged people (with people_names). [] clears. Owned contact ids only."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"description": {
"type": "string",
"description": "Replaces the story text. Empty or null clears."
},
"moment_date": {
"type": "string",
"description": "YYYY-MM-DD, YYYY-MM or YYYY (alias date)."
},
"moment_time": {
"type": "string",
"description": "Optional local HH:mm or HH:mm:ss. Empty or null clears (date-only)."
},
"moment_type": {
"enum": [
"first_met",
"milestone",
"trip",
"achievement",
"memory",
"anniversary",
"life_event",
"relationship",
"career",
"health",
"creative",
"loss",
"other"
],
"type": "string",
"description": "Default memory."
},
"people_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replaces the tagged people (with person_ids); names match saved contacts only."
},
"location_name": {
"type": "string",
"description": "Replaces the place. Empty or null clears. Alias: location."
},
"cover_image_url": {
"type": "string",
"description": "https image link. Empty or null clears."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"moment_date_precision": {
"enum": [
"exact",
"month",
"year",
"circa"
],
"type": "string",
"description": "How exact the date is. YYYY-MM and YYYY default to month and year; circa for \"around then\"."
}
},
"additionalProperties": false
}| Client idempotency key (retries return original result). |
| before_fame | string |
| birth_place | string |
| family_life | string |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"bio": {
"type": "string"
},
"flag": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Notable person slug (e.g. taylor-swift)"
},
"about": {
"type": "string"
},
"trivia": {
"type": "string"
},
"zodiac": {
"type": "string"
},
"net_worth": {
"type": "string"
},
"residence": {
"type": "string"
},
"birth_date": {
"type": "string",
"description": "YYYY, YYYY-MM, or YYYY-MM-DD. Null/empty clears"
},
"occupation": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"before_fame": {
"type": "string"
},
"birth_place": {
"type": "string"
},
"family_life": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| string |
| From create_pending_reply or get_pending_replies. |
| person_id | string |
| request_id | string | Client idempotency key (retries return original result). |
| person_name | string |
| received_at | string |
| snooze_until | string | ISO date-time, with status snoozed. |
| draft_message | string | Alias for draft. |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"required": [
"reply_id"
],
"properties": {
"draft": {
"type": "string",
"description": "The reply text to send later, max 20,000 characters. Replaces the saved draft; empty or null clears. Alias: draft_message."
},
"source": {
"type": "object",
"properties": {
"kind": {
"enum": [
"gmail",
"email",
"other"
],
"type": "string"
},
"thread_id": {
"type": "string"
},
"message_id": {
"type": "string"
}
},
"description": "The email the reply answers, as ids only (e.g. a search_gmail id is a message_id). Never a subject, sender or text. On update, null clears it.",
"additionalProperties": false
},
"status": {
"enum": [
"pending",
"snoozed"
],
"type": "string"
},
"channel": {
"type": "string",
"description": "Where to reply: whatsapp, email, sms, call, imessage, telegram, instagram, facebook, signal, linkedin, twitter, slack, reddit, teams, work_email, zoom, dayze, other; the platform the conversation is on (a Reddit thread is reddit, an Instagram group instagram). Default email when source is set, else other."
},
"summary": {
"type": "string",
"description": "One line (max 280) in your own words: what the reply is about. Never paste the email body, subject line or sender address."
},
"category": {
"enum": [
"personal",
"work"
],
"type": "string"
},
"reply_id": {
"type": "string",
"description": "From create_pending_reply or get_pending_replies."
},
"person_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"person_name": {
"type": "string"
},
"received_at": {
"type": "string"
},
"snooze_until": {
"type": "string",
"description": "ISO date-time, with status snoozed."
},
"draft_message": {
"type": "string",
"description": "Alias for draft."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}| is_favorite |
| boolean |
| Favorite flag. Favorites (and VIP) appear in get_context_pack inner_circle |
| context_tags | array | Contexts such as Work, Personal, Family, plus custom tags |
| relationship | string | Relationship label (friend, sister, …). Empty or null clears |
| relationships | array | Who they are to the user, in primary-first order (for example Friend + Client) |
| idempotency_key | string | Alias for request_id. |
| preserve_old_name_as_alias | boolean | When renaming, keep the previous name as a former_name alias (default true) |
{
"type": "object",
"required": [
"person_id"
],
"properties": {
"name": {
"type": "string",
"description": "Rename contact (also refreshes URL slug). Prefer this over create+merge for spelling fixes"
},
"tier": {
"enum": [
"vip",
"normal",
"low"
],
"type": "string",
"description": "Relationship priority. VIP stays in inner_circle even when not favorited"
},
"notes": {
"type": "string",
"description": "Replaces people.notes (does not append). Empty or null clears"
},
"wallets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "ENS or SNS name (e.g. zzuper.eth)"
},
"chain": {
"enum": [
"eth",
"base",
"sol"
],
"type": "string"
},
"address": {
"type": "string",
"description": "Optional raw 0x or Solana address"
}
},
"additionalProperties": false
},
"description": "PHI-930: full list of ENS (.eth) / SNS (.sol) names and/or addresses for this contact. Merged into social_handles (legacy ens/ens_address kept); empty array clears wallet keys only."
},
"birthday": {
"type": "string",
"description": "YYYY, YYYY-MM, YYYY-MM-DD, or MM-DD / --MM-DD (year unknown; 02-29 ok). Null/empty clears"
},
"person_id": {
"type": "string",
"description": "UUID of a person the authenticated user owns"
},
"request_id": {
"type": "string",
"description": "Required on personal-write OAuth. Unique for a new write; reuse for an exact retry."
},
"is_favorite": {
"type": "boolean",
"description": "Favorite flag. Favorites (and VIP) appear in get_context_pack inner_circle"
},
"context_tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Contexts such as Work, Personal, Family, plus custom tags"
},
"relationship": {
"type": "string",
"description": "Relationship label (friend, sister, …). Empty or null clears"
},
"relationships": {
"type": "array",
"items": {
"type": "string"
},
"description": "Who they are to the user, in primary-first order (for example Friend + Client)"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"preserve_old_name_as_alias": {
"type": "boolean",
"description": "When renaming, keep the previous name as a former_name alias (default true)"
}
},
"additionalProperties": false
}| array |
{
"type": "object",
"required": [
"person_id"
],
"properties": {
"force": {
"type": "boolean"
},
"aliases": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"website": {
"type": "string"
},
"pronouns": {
"type": "string"
},
"person_id": {
"type": "string"
},
"legal_name": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"preferred_name": {
"type": "string"
},
"social_handles": {
"type": "object",
"additionalProperties": true
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"user_relationships": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"additionalProperties": false
}| latitude |
| number |
| place_id | string |
| longitude | number |
| request_id | string | Client idempotency key (retries return original result). |
| description | string |
| price_level | string |
| hours_source | string |
| affordability | string |
| opening_hours | string |
| phone_numbers | array |
| idempotency_key | string | Alias for request_id. |
| business_contact_id | string |
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"area": {
"type": "string"
},
"city": {
"type": "string"
},
"name": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"hours": {
"type": "string"
},
"notes": {
"type": "string"
},
"phone": {
"type": "string"
},
"address": {
"type": "string"
},
"country": {
"type": "string"
},
"website": {
"type": "string"
},
"category": {
"type": "string"
},
"latitude": {
"type": "number"
},
"place_id": {
"type": "string"
},
"longitude": {
"type": "number"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"description": {
"type": "string"
},
"price_level": {
"type": "string"
},
"hours_source": {
"type": "string"
},
"affordability": {
"type": "string"
},
"opening_hours": {
"type": "string"
},
"phone_numbers": {
"type": "array",
"items": {
"type": "string"
}
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"business_contact_id": {
"type": "string"
}
},
"additionalProperties": false
}| request_id | string | Client idempotency key (retries return original result). |
| description | string |
| entity_type | string | event | expense | place | person | inventory (inventory_item maps to inventory) | … |
| content_type | string | Alias for mime_type. |
| image_base64 | string | Base64 image bytes (optional data: URL prefix). |
| idempotency_key | string | Alias for request_id. |
| parent_asset_id | string |
{
"type": "object",
"anyOf": [
{
"required": [
"image_base64"
]
},
{
"required": [
"url"
]
},
{
"required": [
"image"
]
}
],
"properties": {
"url": {
"type": "string",
"description": "Remote image URL to fetch and store."
},
"role": {
"enum": [
"original",
"processed",
"thumbnail",
"cover",
"document",
"receipt",
"certificate",
"photo",
"other"
],
"type": "string",
"description": "original | cover | thumbnail | …"
},
"image": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"description": "ChatGPT file id (not a Dayze asset_id)."
},
"file_name": {
"type": "string",
"description": "Optional original filename from ChatGPT."
},
"mime_type": {
"type": "string",
"description": "Optional MIME type from ChatGPT."
},
"download_url": {
"type": "string",
"description": "Temporary HTTPS URL ChatGPT provides for this file."
}
},
"description": "ChatGPT chat attachment. Prefer this for images from the conversation; API clients may still use image_base64 or url.",
"additionalProperties": false
},
"filename": {
"type": "string"
},
"metadata": {
"type": "object",
"description": "Free-form metadata, merged into the stored metadata (metadata.source becomes the asset source)."
},
"entity_id": {
"type": "string"
},
"mime_type": {
"type": "string",
"description": "image/jpeg, image/png, image/webp, … Alias: content_type."
},
"asset_type": {
"type": "string",
"description": "photo | receipt | certificate | document | thumbnail | …"
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"description": {
"type": "string"
},
"entity_type": {
"type": "string",
"description": "event | expense | place | person | inventory (inventory_item maps to inventory) | …"
},
"content_type": {
"type": "string",
"description": "Alias for mime_type."
},
"image_base64": {
"type": "string",
"description": "Base64 image bytes (optional data: URL prefix)."
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
},
"parent_asset_id": {
"type": "string"
}
},
"additionalProperties": false
}| mime_type |
| string |
| Alias for content_type. |
| request_id | string | Client idempotency key (retries return original result). |
| description | string |
| entity_type* | string |
| content_type | string |
| image_base64 | string | Base64 image bytes (optional data: URL prefix). |
| set_as_avatar | boolean |
| idempotency_key | string | Alias for request_id. |
{
"type": "object",
"anyOf": [
{
"required": [
"image_base64"
]
},
{
"required": [
"url"
]
},
{
"required": [
"image"
]
},
{
"required": [
"asset_id"
]
}
],
"required": [
"entity_type",
"entity_id"
],
"properties": {
"url": {
"type": "string",
"description": "Remote image URL to fetch and store."
},
"role": {
"type": "string",
"description": "original | cover | thumbnail | receipt | … (photo is stored as original). set_as_avatar implies cover."
},
"image": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"description": "ChatGPT file id (not a Dayze asset_id)."
},
"file_name": {
"type": "string",
"description": "Optional original filename from ChatGPT."
},
"mime_type": {
"type": "string",
"description": "Optional MIME type from ChatGPT."
},
"download_url": {
"type": "string",
"description": "Temporary HTTPS URL ChatGPT provides for this file."
}
},
"description": "ChatGPT chat attachment. Prefer this for images from the conversation; API clients may still use image_base64 or url.",
"additionalProperties": false
},
"title": {
"type": "string"
},
"asset_id": {
"type": "string",
"description": "Repair saved upload: new request_id, no image bytes."
},
"filename": {
"type": "string"
},
"entity_id": {
"type": "string"
},
"mime_type": {
"type": "string",
"description": "Alias for content_type."
},
"request_id": {
"type": "string",
"description": "Client idempotency key (retries return original result)."
},
"description": {
"type": "string"
},
"entity_type": {
"type": "string"
},
"content_type": {
"type": "string"
},
"image_base64": {
"type": "string",
"description": "Base64 image bytes (optional data: URL prefix)."
},
"set_as_avatar": {
"type": "boolean"
},
"idempotency_key": {
"type": "string",
"description": "Alias for request_id."
}
},
"additionalProperties": false
}