MemoryPlugin MCP Server

An MCP (Model Context Protocol) server for MemoryPlugin, enabling AI assistants like Claude to store and retrieve your memories. This server provides a bridge between AI assistants and your MemoryPlugin account, allowing them to:

• Store new memories and organize them into buckets
• Search your memories with hybrid semantic + keyword search
• Browse Smart Memory categories and their summaries
• Edit memories or move them between buckets
• Recall your imported chat history from ChatGPT, Claude, and other AI tools
• Read or summarize a specific past conversation
• Fetch the full transcript of a past conversation as structured JSON for deeper analysis
• Search documents you uploaded to MemoryPlugin

Setup

Getting Your API Token

1. Go to www.memoryplugin.com/dashboard
2. Find your API token in the dashboard
3. Copy the token for use in configuration

Claude Desktop Configuration

Configure the server in your Claude Desktop configuration file:

Option 1: Using npx (recommended, but currently experiencing issues)

{
  "mcpServers": {
    "memoryplugin": {
      "command": "npx",
      "args": ["-y", "@memoryplugin/mcp-server"],
      "env": {
        "MEMORY_PLUGIN_TOKEN": "your-token-here"
      }
    }
  }
}

Option 2: Using global installation (current workaround)

First, install the package globally:

npm install -g @memoryplugin/mcp-server

Then find your Node.js installation path:

which node
# Example output: /Users/username/.nvm/versions/node/v21.7.3/bin/node

And find the installed package path:

npm root -g
# Look for something like: /Users/username/.nvm/versions/node/v22.14.0/lib/node_modules

Add @memoryplugin/mcp-server/dist/index.js to the end of the path you received in the previous step.

So the final path should look like:

/Users/username/.nvm/versions/node/v22.14.0/lib/node_modules/@memoryplugin/mcp-server/dist/index.js

Use these paths in your configuration:

{
  "mcpServers": {
    "memoryplugin": {
      "command": "/Users/username/.nvm/versions/node/v21.7.3/bin/node",
      "args": [
        "/Users/username/.nvm/versions/node/v21.7.3/lib/node_modules/@memoryplugin/mcp-server/dist/index.js"
      ],
      "env": {
        "MEMORY_PLUGIN_TOKEN": "your-token-here"
      }
    }
  }
}

If you experience any startup issues with Option 2, please use Option 1 with global installation instead.

Available Tools

The MCP server exposes these tools to AI assistants:

Memories

1. store_memory — save a new memory, optionally into a specific bucket
2. search_memories — hybrid semantic + keyword search over your saved memories
3. get_memories_and_buckets — fetch recent or all memories (optionally by bucket) along with your bucket list
4. list_buckets — view all memory buckets with memory counts
5. create_bucket — create a new bucket to organize memories by topic
6. list_bucket_categories — list Smart Memory categories inside a bucket, each with a summary
7. list_category_memories — load the full memories of one Smart Memory category
8. update_or_move_memories — edit a memory's text, or move one or many memories to another bucket

Chat history

9. recall_chat_history — search your imported past conversations across AI tools; supports parallel queries, token budgets, date bounds, and a quality mode
10. get_conversation_summary — AI-generated summary of one past conversation (needs 5,000+ tokens; for shorter chats use get_full_conversation)
11. get_full_conversation — the complete transcript of one past conversation
12. export_conversation — a temporary download URL (expires in 15 minutes, no auth needed) the assistant fetches to get one past conversation as a structured JSON file, for transcripts too long to read inline or destined for file-based processing

Files

13. search_uploaded_files — search documents you uploaded to your MemoryPlugin file buckets

Example Usage

Here are some example prompts you can use with Claude once the server is configured:

Could you store this as a memory: "Had coffee with Sarah at Blue Bottle, discussed upcoming project deadlines"

Can you show me my latest 5 memories?

Could you create a new bucket called "Work Meetings"?

Search my memories for anything related to "coffee meetings"

Show me the categories in my main bucket

What did we decide about the pricing page? Check my past conversations.

Go through my whole conversation about the pricing redesign and pull out every action item

Support

For any issues or questions, please contact support@memoryplugin.com

License

MIT. See LICENSE.