Notes across all accounts
notes.feed.v2
Use when: Find notes across the whole workspace, newest first: since a date, by people or agents, on accounts you own (owner=me), or only notes with action items not yet made into tasks (has_unconverted_action_items).
Avoid when: You want one account's or contact's notes in full; use notes.list.v2 on that entity.
Effects: Read only. Bodies are cut at 1,500 characters.
Cost: No gateway credit charge; reads saved workspace data without starting paid provider work. Gateway rate code: none; downstream billing may apply.
Access: accounts:read. Approval: operation authorization. Reads do not need an operation UUID.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.tasks.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "notes.feed.v2",
"arguments": {
"has_unconverted_action_items": true,
"owner": "me"
},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}Input schema: fields, defaults and constraints
{
"additionalProperties": false,
"properties": {
"since": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Only notes that occurred at or after this time.",
"title": "Since"
},
"cursor": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "next_cursor from the previous page.",
"title": "Cursor"
},
"author_type": {
"anyOf": [
{
"enum": [
"user",
"agent"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Author type used by the notes feed input v2 operation.",
"title": "Author Type"
},
"owner": {
"anyOf": [
{
"maxLength": 36,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The account owner: 'me' or a user id.",
"title": "Owner"
},
"has_unconverted_action_items": {
"default": false,
"description": "Only notes whose latest scan lists action items no task was made from yet.",
"title": "Has Unconverted Action Items",
"type": "boolean"
},
"limit": {
"default": 10,
"description": "Maximum number of records to return in this page.",
"maximum": 20,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"title": "McpNotesFeedInputV2",
"type": "object"
}Output schema inside the result envelope
{
"$defs": {
"NoteActionItemsV2": {
"additionalProperties": false,
"properties": {
"scanned": {
"default": false,
"title": "Scanned",
"type": "boolean"
},
"count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Count"
},
"converted": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Converted"
}
},
"title": "NoteActionItemsV2",
"type": "object"
},
"NoteFeedItemV2": {
"additionalProperties": false,
"properties": {
"note_id": {
"title": "Note Id",
"type": "string"
},
"entity_type": {
"enum": [
"account",
"contact"
],
"title": "Entity Type",
"type": "string"
},
"entity_id": {
"title": "Entity Id",
"type": "string"
},
"account_id": {
"title": "Account Id",
"type": "string"
},
"account_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Account Name"
},
"entity_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Entity Name"
},
"body": {
"title": "Body",
"type": "string"
},
"body_truncated": {
"default": false,
"title": "Body Truncated",
"type": "boolean"
},
"author_type": {
"title": "Author Type",
"type": "string"
},
"author_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Author Name"
},
"occurred_at": {
"format": "date-time",
"title": "Occurred At",
"type": "string"
},
"revision": {
"title": "Revision",
"type": "integer"
},
"action_items": {
"$ref": "#/$defs/NoteActionItemsV2"
},
"web_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Web Url"
}
},
"required": [
"note_id",
"entity_type",
"entity_id",
"account_id",
"body",
"author_type",
"occurred_at",
"revision",
"action_items"
],
"title": "NoteFeedItemV2",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"notes": {
"default": [],
"items": {
"$ref": "#/$defs/NoteFeedItemV2"
},
"title": "Notes",
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Cursor"
}
},
"title": "NotesFeedResultV2",
"type": "object"
}