--- title: "Mem0 MCP" description: "Connect any AI client to Mem0 using Model Context Protocol in minutes" icon: "puzzle-piece" estimatedTime: "~2 minutes" --- **Prerequisites** - Mem0 Platform account (Sign up here) - API key (Get one from dashboard) - Node.js 14+ (for npx) - An MCP-compatible client (Claude, Claude Code, Cursor, Windsurf, VS Code, OpenCode) ## What is Mem0 MCP? Mem0 MCP Server exposes Mem0's memory capabilities as MCP tools, letting AI agents decide when to save, search, or update information. The cloud-hosted MCP server requires no local installation — just connect and start using memory. ## Quick Setup Add Mem0 MCP to your preferred clients with a single command: ```bash npx mcp-add \ --name mem0-mcp \ --type http \ --url "https://mcp.mem0.ai/mcp" \ --clients "claude,claude code,cursor,windsurf,vscode,opencode" ``` This automatically configures Mem0 MCP for all supported clients at once. ## Available Tools The MCP server exposes these memory tools to your AI client: | Tool | Description | |------|-------------| | `add_memory` | Save text or conversation history for a user/agent | | `search_memories` | Semantic search across existing memories with filters | | `get_memories` | List memories with structured filters and pagination | | `get_memory` | Retrieve one memory by its `memory_id` | | `update_memory` | Overwrite a memory's text after confirming the ID | | `delete_memory` | Delete a single memory by `memory_id` | | `delete_all_memories` | Bulk delete all memories in scope | | `delete_entities` | Delete a user/agent/app/run entity and its memories | | `list_entities` | Enumerate users/agents/apps/runs stored in Mem0 | --- ## Client-Specific Setup You can also configure individual clients: ```bash npx mcp-add \ --name mem0-mcp \ --type http \ --url "https://mcp.mem0.ai/mcp" \ --clients "claude" ``` Or manually add to your Claude Desktop configuration (`claude_desktop_config.json`): ```json { "mcpServers": { "mem0-mcp": { "type": "http", "url": "https://mcp.mem0.ai/mcp" } } } ``` ```bash npx mcp-add \ --name mem0-mcp \ --type http \ --url "https://mcp.mem0.ai/mcp" \ --clients "claude code" ``` ```bash npx mcp-add \ --name mem0-mcp \ --type http \ --url "https://mcp.mem0.ai/mcp" \ --clients "cursor" ``` Or go to Cursor → Settings → MCP and add: ```json { "mcpServers": { "mem0-mcp": { "type": "http", "url": "https://mcp.mem0.ai/mcp" } } } ``` ```bash npx mcp-add \ --name mem0-mcp \ --type http \ --url "https://mcp.mem0.ai/mcp" \ --clients "windsurf" ``` ```bash npx mcp-add \ --name mem0-mcp \ --type http \ --url "https://mcp.mem0.ai/mcp" \ --clients "vscode" ``` ```bash npx mcp-add \ --name mem0-mcp \ --type http \ --url "https://mcp.mem0.ai/mcp" \ --clients "opencode" ``` --- ## Verify Your Setup Once configured, your AI client can: - Automatically save information with `add_memory` - Search memories with `search_memories` - Update memories with `update_memory` - Delete memories with `delete_memory` **Sample Interactions:** ``` User: Remember that I love tiramisu Agent: Got it! I've saved that you love tiramisu. User: What do you know about my food preferences? Agent: Based on your memories, you love tiramisu. User: Update my project: the mobile app is now 80% complete Agent: Updated your project status successfully. ``` If you get "Connection failed", ensure you have a valid API key from Mem0 Dashboard. --- ## Quick Recovery - **"Connection refused"** → Check your internet connection and ensure the MCP client is correctly configured - **"Invalid API key"** → Get a new key from Mem0 Dashboard - **"npx command not found"** → Install Node.js from [nodejs.org](https://nodejs.org) --- ## Next Steps ## Additional Resources - **[Platform Quickstart](/platform/quickstart)** - Direct API integration guide - **[MCP Specification](https://modelcontextprotocol.io)** - Learn about MCP protocol