> ## Documentation Index
> Fetch the complete documentation index at: /dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# notes_find

> Plans several searches, reads the notes and keeps the ones that help.

> [!NOTE]
>
> Uses credits · Your own key only

Give it one question in plain words. It plans its own searches, follows links, reads every note and keeps only the useful ones, each with the exact quote and why it helps. It takes up to about a minute and uses the person's Constella credits (about 20-40 a call).

Call it at `POST /platform/v1/me/tools/notes_find`. On MCP, your AI tool calls `notes_find` with the same arguments.

## Arguments

Send these inside `arguments`.

**question** `string` *required*

The question, in plain words. One question, not a list of searches.

**max** `integer` (default: 12)

How many notes to return, 1-60.

**exclude\_ids** `string[]` (default: null)

Ids to leave out, like ones you already have.

## Returns

The tool's answer comes back under `result`.

**notes** `object[]`

Best first. Each has `id`, `title`, `quote` (the exact words), `passages`, `why` (what it adds), `score`, `source`, `type` and `date`.

**queries** `string[]`

The searches it planned.

**cost\_usd** `number`

What the call cost.

```bash Your key theme={"system"}
curl https://api.constella.app/platform/v1/me/tools/notes_find \
  -H "Authorization: Bearer $CONSTELLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"question": "What did we decide about the team plan price?"}}'
```

```python Python theme={"system"}
import os, requests

r = requests.post(
    "https://api.constella.app/platform/v1/me/tools/notes_find",
    headers={"Authorization": f"Bearer {os.environ['CONSTELLA_API_KEY']}", "X-Constella-Client": "my-script"},
    json={"arguments": {"question": "What did we decide about the team plan price?"}},
)
print(r.json()["result"])
```

```javascript JavaScript theme={"system"}
const res = await fetch("https://api.constella.app/platform/v1/me/tools/notes_find", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CONSTELLA_API_KEY}`,
    "X-Constella-Client": "my-script",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"arguments": {"question": "What did we decide about the team plan price?"}}),
});
const { result } = await res.json();
```

```json 200 theme={"system"}
{
  "result": {
    "notes": [
      {
        "id": "9f2c...",
        "title": "Pricing call notes",
        "quote": "Team plan stays at $20 a seat.",
        "why": "States the decision.",
        "score": 0.83
      }
    ],
    "queries": [
      "team plan price decision"
    ]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.