Documentation

Overview

Reflect Memory gives your AI tools shared memory. Store something in one tool and every connected tool can access it: ChatGPT, Claude, Cursor, Gemini, and more. All data is scoped to your account and privacy-first.

Base URL: https://api.reflectmemory.com

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer <your-api-key>

User key: Full access. Used for direct API calls, scripts, and the dashboard. Get this from your account settings.

Agent keys: Scoped per vendor (e.g., chatgpt, claude). Used by AI integrations. Each agent only sees memories where allowed_vendors includes"*" or their vendor name.

API Endpoints

Agent endpoints (used by AI integrations):

• GET /agent/memories/latest Most recent memory. Optional ?tag= filter.
• GET /agent/memories/{id} Full memory by UUID.
• POST /agent/memories Create a memory.
• POST /agent/memories/browse List summaries (no content).
• POST /agent/memories/by-tag Full memories by tags.
• POST /query AI query with memory context.
• GET /whoami Resolve identity from key.

User endpoints (dashboard, scripts): POST /memories,PUT /memories/:id,DELETE /memories/:id,POST /memories/list.

MCP Server

Reflect Memory exposes a Model Context Protocol (MCP) server for Claude and other MCP-compatible hosts. Connect to:

https://api.reflectmemory.com/mcp

Transport: Streamable HTTP.

Auth: OAuth 2.1 (for Claude native connector) or Bearer token (for Cursor, xAI API, n8n, and other MCP clients). Claude handles OAuth automatically when you add the connector URL.

Tools (7): read_memories, get_memory_by_id, get_latest_memory, browse_memories, search_memories, get_memories_by_tag, write_memory. All tools are scoped to the authenticated user. Read-only tools do not modify data; write_memory creates new entries.

Integrations

• ChatGPT Custom GPT: Use our ready-made Reflect Memory GPT or add actions using the OpenAPI spec with your agent key.
• Claude (native connector): Go to Claude.ai Settings, Connectors, click +, paste https://api.reflectmemory.com/mcp as the URL, and click Add. Claude discovers all 7 memory tools automatically via OAuth. No extension or downloads needed.
• Cursor (remote MCP): Add a .cursor/mcp.json file to your project with the MCP URL and your agent key as a Bearer token header. Cursor discovers all 7 memory tools automatically. No npm install or local server needed.
• Grok: Install the Reflect Memory Chrome Extension and paste your agent key. The extension automatically injects your memory context into Grok conversations and saves important decisions. Developers can also use the xAI API's native remote MCP support.
• Gemini: Install the Reflect Memory Chrome Extension and paste your agent key. The extension automatically injects your memory context into Gemini conversations. Works with Gemini's built-in memory seamlessly.
• Perplexity: The Chrome Extension captures conversation context from Perplexity and saves it to your shared memory. Note: Perplexity is search-first, so memory context injection has limited effect on search results.

Setup guides: /integrations

Data Model

Each memory has:

• id: UUID
• title: Short descriptor
• content: Full text
• tags: Array of strings
• memory_type: "semantic", "episodic", or "procedural"
• origin: Which AI/service wrote it (chatgpt, claude, cursor, etc.)
• allowed_vendors: Who can see it (["*"] = all)
• created_at, updated_at: ISO 8601 timestamps

Memory Types

Memories can be classified into three types to improve retrieval and context:

• semantic: Facts, knowledge, and general information (default)
• episodic: Events, experiences, and decisions tied to specific moments
• procedural: Workflows, patterns, and how-to knowledge

Support

Documentation: this page. Privacy: /privacy. Terms: /terms. Support: sales@reflectmemory.com.