blob: 51f097ed5bd76e68ac139f0a4ad56de4b7279b2a (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
---
title: 'About Supermemory MCP'
description: 'Give your AI assistants persistent memory with the Model Context Protocol'
---
Supermemory MCP Server 4.0 is a lightweight component that gives AI assistants persistent memory across conversations. It serves as a universal memory layer enabling Large Language Models (LLMs) to maintain context and memories across different applications and sessions, solving the fundamental limitation of AI assistants forgetting everything between conversations.
<Card title="Quick Start" icon="rocket" href="/supermemory-mcp/mcp">
Jump to installation and setup
</Card>
## What Supermemory MCP Does
**Supermemory MCP** functions as a universal memory system that bridges AI applications through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io). It operates as an **MCP server** that communicates with MCP-compatible clients, storing and retrieving contextual information through the Supermemory API infrastructure.
When users interact with any connected AI application, the system captures relevant information and makes it available across all other connected platforms through **semantic search and intelligent retrieval**.
### Supported Platforms
- **Claude Desktop** - Direct MCP protocol support
- **Cursor IDE** - Global MCP server configuration via `~/.cursor/mcp.json`
- **Windsurf** - Seamless integration for AI-powered development
- **VS Code** - Compatible with AI coding extensions
- **Cline/Roo-Cline** - Full MCP protocol support
- **Any MCP-compatible application** - Universal compatibility through standard protocol
### Key Features
- **OAuth Authentication** - Secure login through Supermemory accounts
- **API Key Support** - Alternative authentication for automation and CI/CD
- **Persistent Memory** - Save and recall information across sessions
- **User Profiles** - Auto-generated profiles from stored memories
- **Project Scoping** - Organize memories by project with `x-sm-project` header
## Core Workflow
1. User interacts with any MCP-compatible AI client
2. The client connects to `https://mcp.supermemory.ai/mcp`
3. OAuth flow authenticates the user (or API key validates directly)
4. During conversations, relevant information is stored using the `memory` tool
5. When context is needed, the `recall` tool retrieves relevant memories
6. The AI assistant accesses this persistent context regardless of which platform is being used
## Security and Privacy
### Authentication Model
- **OAuth by default** - Secure authentication through Supermemory accounts
- **API key alternative** - Keys start with `sm_` for programmatic access
- **Session isolation** - Complete user data separation per account
### Privacy Features
- **Data isolation** - User memories completely separated by account
- **Secure infrastructure** - Built on Cloudflare's enterprise-grade platform
- **Open source** - Full transparency into how your data is handled
<Card title="Source Code" icon="github" href="https://github.com/supermemoryai/supermemory/tree/main/apps/mcp">
View the open-source implementation
</Card>
|