---
title: "Search Notes"
method: POST
path: "/v2/mcp/notes/search"
tags: ["external", "external-v2"]
---

# Search Notes

`POST /v2/mcp/notes/search`

## Request

- Base URL: `https://api.mem.ai`
- URL: `https://api.mem.ai/v2/mcp/notes/search`
- Auth: HTTP bearer

## Request body

- SearchNotesRequestSchema
  - `limit` integer: Maximum number of notes to return.
  - `offset` integer: Number of matching notes to skip before returning results.
  - `query` string, required: Free-text query used to search across the caller's notes.

## Response `200`

OK

- SearchNotesResponseSchema
  - `limit` integer, required: Limit applied to the search results.
  - `offset` integer, required: Offset applied before returning results.
  - `results` SearchNotesResultSchema[]: Matching notes ordered by relevance.
    - `created_at` string, date-time, required: Timestamp representing when the note was created.
    - `id` string, uuid, required: Unique identifier of the note.
    - `primary_label` string, required: Primary label or title associated with the note.
    - `secondary_label` string, nullable: Secondary label for the note if available.
    - `snippet` string, nullable: Optional snippet derived from the note content.
    - `updated_at` string, date-time, required: Timestamp representing when the note was last updated.
  - `total` integer, required: Total number of matching notes before pagination.

## Changes

- **2026-11-03** `503bb357d07c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mem/apis/mem-public-client-api/changes/v2/mcp/notes/search/post.md)

---

[API](https://skmtc.dev/mem/apis/mem-public-client-api.md) - [All operations](https://skmtc.dev/mem/apis/mem-public-client-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mem/apis/mem-public-client-api/revisions/503bb357d07c?raw)