# MemoryPlugin MCP Server

An MCP (Model Context Protocol) server for [MemoryPlugin](https://www.memoryplugin.com), 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](https://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)

```json
{
  "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:

```bash
npm install -g @memoryplugin/mcp-server
```

Then find your Node.js installation path:

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

And find the installed package path:

```bash
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:

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

Use these paths in your configuration:

```json
{
  "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](LICENSE).