# Mem — how to use (mcp.ai)

Connect your Mem account and use 11 tools for notes straight from your AI agent. Connect with your own API key. Mem is a note-taking and knowledge management application that helps users capture, organize, and retrieve information efficiently.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_mem?ms=1787295720000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `mem_create_collection`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/mem`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/mem/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/mem/create/collection` — Creates a new collection in Mem for organizing and grouping related notes. Collections are containers that help categorize notes by topic, project, or any organizational scheme. Each collection has a 
  - body: { id?: string, title: string, created_at?: string, updated_at?: string, description?: string }
- `POST https://api.mcp.ai/api/mem/create/note/v2` — Tool to create a new note with markdown content and optional collection associations. The first line of content is automatically interpreted as the title. Use when you need to create a note and option
  - body: { id?: string, content: string, created_at?: string, updated_at?: string, collection_ids?: string[], collection_titles?: string[] }
- `POST https://api.mcp.ai/api/mem/delete/collection` — Tool to permanently delete a Mem collection. Deletion is irreversible — only invoke after explicit user confirmation and verification of the correct collection_id.
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/mem/delete/note` — Tool to permanently delete a specific note. Deletion is irreversible — obtain explicit user confirmation before calling. Use when you need to remove a note by its unique identifier after confirming th
  - body: { note_id: string }
- `POST https://api.mcp.ai/api/mem/get/collection` — Retrieve the details of a Mem collection by its UUID. Returns the collection's title, description, and timestamps. Use this when you need to fetch metadata for a specific collection.
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/mem/list/collections` — List collections with pagination support. Returns collections sorted by updated_at or created_at. Use this action to retrieve all collections or browse through collections page by page.
  - body: { page?: string, limit?: integer, order_by?: string }
- `POST https://api.mcp.ai/api/mem/list/notes` — Tool to list notes with pagination and filtering options. Supports filtering by collection, task presence, image presence, and file presence. Use when you need to retrieve multiple notes or search for
  - body: { page?: string, limit?: integer, order_by?: string, collection_id?: string, contains_files?: boolean, contains_tasks?: boolean, contains_images?: boolean, contains_open_tasks?: boolean, include_note_content?: boolean }
- `POST https://api.mcp.ai/api/mem/read/note` — Retrieve the content and metadata of a Mem note by its UUID. Returns the note's title, markdown content, timestamps, and collection membership. Use this when you need to read or display an existing no
  - body: { note_id: string }
- `POST https://api.mcp.ai/api/mem/save/content` — Tool to process and remember any raw content using AI. Accepts web pages, emails, transcripts, articles, or simple text. Use when you want to save and process content with optional instructions on how
  - body: { input: string, context?: string, timestamp?: string, instructions?: string }
- `POST https://api.mcp.ai/api/mem/search/collections` — Tool to search collections using an optional query string. Use when you need to find or list collections by title or description.
  - body: { query?: string }
- `POST https://api.mcp.ai/api/mem/search/notes` — Tool to search notes in Mem using a query string with optional filtering. Supports filtering by collection IDs, task presence, image presence, and file presence.
  - body: { limit?: integer, query?: string, config?: object, offset?: integer, snapshot_id?: string, filter_by_collection_ids?: string[], filter_by_contains_files?: boolean, filter_by_contains_tasks?: boolean, filter_by_contains_images?: boolean, filter_by_contains_open_tasks?: boolean }

## Example prompts
- "What can I do in Mem?"
- "Show me a summary of my Mem account"

## More
- Page: https://mcp.ai/mem
- Agent spec (llms.txt): https://mcp.ai/mem/llms.txt
- Postman collection: https://mcp.ai/mem/postman.json