Back to Dashboard
pūrmemo
Documentation

pūrmemo Docs

Automatic conversation memory for ChatGPT, Claude, and Gemini. Set up in 5 minutes.

Last Updated: December 8, 20255 minute read

Getting Started

pūrmemo automatically captures your AI conversations from ChatGPT, Claude, and Google Gemini. Get started in 5 minutes.

1

Create an Account

Visit app.purmemo.ai and sign up using Google OAuth, GitHub OAuth, or email.

2

Install Chrome Extension

Download from the Chrome Web Store and authenticate with your pūrmemo account.

Important: The extension automatically captures all conversations on ChatGPT, Claude, and Gemini. This feature cannot be disabled.

3

Start Chatting

Open ChatGPT, Claude, or Gemini and start chatting. Your conversations are automatically saved in real-time.

4

Search and Recall

Use the dashboard at app.purmemo.ai/dashboard to search, view, edit, and export your memories.

Chrome Extension

How Auto-Capture Works

The extension runs in the background on supported AI platforms and automatically captures conversations as you chat. No manual saving required.

Supported Platforms

  • ChatGPT: chat.openai.com, chatgpt.com
  • Claude: claude.ai
  • Google Gemini: gemini.google.com

Permissions Required

storage

Saves your authentication token and settings locally

activeTab

Accesses the current tab when the extension is active

scripting

Injects content scripts to detect and capture conversations

Technical Details

  • Uses MutationObserver to watch for new messages in the DOM
  • 500ms debounce delay to prevent excessive API calls
  • Captures both user messages and AI responses
  • Automatic context recall for relevant memories

Privacy: The extension only sends data to api.purmemo.ai. No third-party tracking or analytics. Read our Privacy Policy for details.

Web Dashboard

Access your memories at app.purmemo.ai/dashboard

Key Features

Semantic Search

Search all conversations using natural language queries powered by vector embeddings

Memory Management

View, edit, and organize individual memories with tags and metadata

Data Export

Export all your data in JSON format anytime you want

Trash & Recovery

Deleted memories can be recovered within 30 days before permanent deletion

API Access

Full REST API for programmatic access to your memories. Perfect for custom integrations and automation.

Endpoints

GET/api/v1/memories

List all memories with pagination and filtering

POST/api/v1/memories

Create a new memory

PATCH/api/v1/memories/:id

Update an existing memory

DELETE/api/v1/memories/:id

Soft delete a memory (30-day recovery)

GET/api/v1/memories/export

Export all memories in JSON format

Authentication

Generate API keys from your account settings. Include in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Security: API keys are hashed using SHA-256. Never share your keys publicly. You can revoke keys anytime from settings.

MCP Integration

Access your conversation memories from Claude Desktop, Cursor, Windsurf, and other AI platforms via the Model Context Protocol (MCP).

Connection Methods

FeatureRemote (OAuth)Local (API Key)
SetupClick "Add Connector" in ClaudeEdit config file + API key
InstallationNone requiredAuto-downloads via npx
AuthenticationOAuth 2.1 (browser flow)API key in config
UpdatesAutomatic (cloud-hosted)Manual (npm update)
PlatformsClaude Desktop onlyClaude, Cursor, Windsurf, Zed

Option 1: Remote Connection (Recommended)

Cloud-hosted MCP server with OAuth 2.1 authentication. Zero installation, automatic updates.

Setup (Claude Desktop):

  1. Open Claude Desktop
  2. Scroll to bottom of connectors list
  3. Click "Add custom connector (BETA)"
  4. Enter:
    Name: Purmemo
    URL: https://mcp.purmemo.ai/mcp/messages
  5. Sign in with your pūrmemo account via OAuth

Discovery Endpoints: The remote server provides automatic discovery at /.well-known/mcp and OAuth metadata at /.well-known/oauth-authorization-server

Option 2: Local Connection

Runs locally on your machine. Works with Claude Desktop, Cursor, Windsurf, and Zed.

Step 1: Get API Key

Generate an API key from app.purmemo.ai/settings

Step 2: Configure Your Platform

Claude Desktop

Edit config file at:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "purmemo": {
      "command": "npx",
      "args": ["-y", "purmemo-mcp"],
      "env": {
        "PURMEMO_API_KEY": "your-api-key-here"
      }
    }
  }
}
Cursor IDE

Edit config file at:

macOS/Linux: ~/.cursor/mcp.json
Windows: %USERPROFILE%\.cursor\mcp.json
{
  "mcpServers": {
    "purmemo": {
      "command": "npx",
      "args": ["-y", "purmemo-mcp"],
      "env": {
        "PURMEMO_API_KEY": "your-api-key-here",
        "MCP_PLATFORM": "cursor"
      }
    }
  }
}
Windsurf IDE

Edit config file at:

macOS/Linux: ~/.windsurf/mcp.json
Windows: %USERPROFILE%\.windsurf\mcp.json
{
  "mcpServers": {
    "purmemo": {
      "command": "npx",
      "args": ["-y", "purmemo-mcp"],
      "env": {
        "PURMEMO_API_KEY": "your-api-key-here",
        "MCP_PLATFORM": "windsurf"
      }
    }
  }
}
Zed Editor

Edit config file at:

macOS/Linux: ~/.config/zed/mcp.json
{
  "mcpServers": {
    "purmemo": {
      "command": "npx",
      "args": ["-y", "purmemo-mcp"],
      "env": {
        "PURMEMO_API_KEY": "your-api-key-here",
        "MCP_PLATFORM": "zed"
      }
    }
  }
}

Available Tools

save_conversation

Save complete conversations with automatic chunking for large content

recall_memories

Search for relevant memories using semantic search with filters

get_memory_details

Retrieve full memory content including linked parts

discover_related_conversations

Find related memories across all platforms using semantic clusters

Local Privacy: The local MCP server runs on your machine and only sends API requests to api.purmemo.ai. No local SQLite database is used—all data is stored in your pūrmemo account.

NPM Package: Published as purmemo-mcp@12.0.1 on npm. View source at github.com/coladapo/purmemo-mcp

Support & Resources

General Support

Account help, billing, technical issues

Developer Support

API questions, integration help

Additional Resources

Need More Help?

For detailed information about pricing, data handling, and legal policies, please visit: