# List Deal notes

`deals.list_notes`

List the newest private notes attached to one Deal, with the pinned note first. Search note content. Follow next_cursor to read all items. Old signed runs may return notes instead of items. These notes are visible to authorized workspace teammates and are not messages to clients, applicants, or partners. Use the returned note IDs for later edits or deletion.

[Deals guide](https://docs.levr.ai/mcp/resources/deals.md)

Availability depends on live discovery and your access to the record. Do not infer MCP calls from REST paths.

Operation: read. Required OAuth scopes: mcp.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "anyOf": [
        {
          "description": "Opaque next_cursor from the preceding page with the same query.",
          "maxLength": 4096,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Opaque next_cursor from the preceding page with the same query."
    },
    "deal_id": {
      "description": "Copy id from deals.list.",
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "ordering": {
      "default": "-is_pinned,-created_at",
      "description": "Comma-separated ordering fields. Prefix a field with - for descending order. Allowed fields: is_pinned, created_at, updated_at.",
      "maxLength": 255,
      "minLength": 1,
      "pattern": "^-?(?:is_pinned|created_at|updated_at)(?:,-?(?:is_pinned|created_at|updated_at)){0,2}$",
      "type": "string"
    },
    "page_size": {
      "default": 10,
      "description": "Maximum notes per page, from 1 to 20.",
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "provider_slug": {
      "description": "Copy provider_slug from providers.list; named slugs are valid.",
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "search": {
      "default": "",
      "description": "Case-insensitive text search over the fields documented by this tool.",
      "maxLength": 255,
      "type": "string"
    }
  },
  "required": [
    "provider_slug",
    "deal_id"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "oneOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "properties": {
        "ok": {
          "const": true
        }
      },
      "required": [
        "data"
      ]
    },
    {
      "not": {
        "required": [
          "data"
        ]
      },
      "properties": {
        "ok": {
          "const": false
        }
      },
      "required": [
        "error"
      ]
    }
  ],
  "properties": {
    "data": {
      "additionalProperties": false,
      "anyOf": [
        {
          "required": [
            "items",
            "next_cursor"
          ]
        },
        {
          "required": [
            "notes"
          ]
        }
      ],
      "properties": {
        "deal_id": {
          "description": "Copy id from deals.list.",
          "maxLength": 255,
          "minLength": 1,
          "type": "string"
        },
        "items": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "created_by": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "id": {
                "description": "Stable public identifier for the referenced resource.",
                "maxLength": 255,
                "minLength": 1,
                "type": "string"
              },
              "is_pinned": {
                "type": "boolean"
              },
              "plain_text": {
                "type": "string"
              },
              "resource_id": {
                "description": "Stable public identifier for the referenced resource.",
                "maxLength": 255,
                "minLength": 1,
                "type": "string"
              },
              "resource_kind": {
                "enum": [
                  "business",
                  "project",
                  "deal"
                ],
                "type": "string"
              },
              "rich_text": {
                "type": "string"
              },
              "updated_at": {
                "format": "date-time",
                "type": "string"
              }
            },
            "required": [
              "id",
              "resource_kind",
              "resource_id",
              "rich_text",
              "plain_text",
              "is_pinned",
              "created_by",
              "created_at",
              "updated_at"
            ],
            "type": "object"
          },
          "maxItems": 20,
          "type": "array"
        },
        "next_cursor": {
          "type": [
            "string",
            "null"
          ]
        },
        "notes": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "created_by": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "id": {
                "description": "Stable public identifier for the referenced resource.",
                "maxLength": 255,
                "minLength": 1,
                "type": "string"
              },
              "is_pinned": {
                "type": "boolean"
              },
              "plain_text": {
                "type": "string"
              },
              "resource_id": {
                "description": "Stable public identifier for the referenced resource.",
                "maxLength": 255,
                "minLength": 1,
                "type": "string"
              },
              "resource_kind": {
                "enum": [
                  "business",
                  "project",
                  "deal"
                ],
                "type": "string"
              },
              "rich_text": {
                "type": "string"
              },
              "updated_at": {
                "format": "date-time",
                "type": "string"
              }
            },
            "required": [
              "id",
              "resource_kind",
              "resource_id",
              "rich_text",
              "plain_text",
              "is_pinned",
              "created_by",
              "created_at",
              "updated_at"
            ],
            "type": "object"
          },
          "maxItems": 200,
          "type": "array"
        }
      },
      "required": [
        "deal_id"
      ],
      "type": "object"
    },
    "error": {
      "additionalProperties": false,
      "properties": {
        "code": {
          "type": "string"
        },
        "details": {
          "additionalProperties": true,
          "description": "Optional bounded, agent-safe correction or recovery facts.",
          "type": "object"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        }
      },
      "required": [
        "code",
        "message",
        "retryable"
      ],
      "type": "object"
    },
    "meta": {
      "additionalProperties": false,
      "properties": {
        "request_id": {
          "type": "string"
        }
      },
      "required": [
        "request_id"
      ],
      "type": "object"
    },
    "ok": {
      "description": "Whether the tool completed successfully.",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "meta"
  ],
  "type": "object"
}
```