# Memory Entries

> MCP tools for the Memory Entries module. See the [Memory Entries module docs](/docs/modules/memories) for permissions and data model.

# Memory Entries

MCP tools for the Memory Entries module. See the [Memory Entries module docs](/docs/modules/memories) for permissions and data model.

### `list-memory-entries`

List memory entries

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `memory_id` | `string` | yes | Memory container to list entries from (mem_...) |
| `limit` | `number` | no | Maximum number of results to return |
| `offset` | `number` | no | Number of results to skip |
| `include_invalidated` | `boolean` | no | Include invalidated (superseded) entries. They are excluded by default; set this to audit the supersede history. |

### `create-memory-entry`

Create a memory entry

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `memory_id` | `string` | yes | Memory container to add the entry to (mem_...) |
| `content` | `string` | yes | The text content of the memory entry |
| `source_type` | `string` | no | How this entry was created |
| `tags` | `array<string>` | no | Per-entry tag strings, used for entry-granularity filtering in search-knowledge (memory_tags) |
| `metadata` | `object` | no | Arbitrary structured metadata attached to the entry |
| `duplicate_threshold` | `number` | no | Cosine similarity score at or above which the incoming content is considered a duplicate of an existing entry and skipped (default 0.95). Below it the entry is always created. |

### `get-memory-entry`

Get a memory entry

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `entry_id` | `string` | yes | — |

### `update-memory-entry`

Update a memory entry

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `entry_id` | `string` | yes | — |
| `content` | `string` | no | Updated text content |
| `tags` | `array<string> \| null` | no | Replaces the entry's tags. Pass null or an empty array to clear. |
| `metadata` | `object \| null` | no | Replaces the entry's metadata. Pass null to clear. |

### `delete-memory-entry`

Delete a memory entry

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `entry_id` | `string` | yes | — |