Supermemory MCP

https://supermemory.ai/docs/supermemory-mcp/mcp
Admin
Supermemory MCP is a Model Context Protocol server that gives AI assistants persistent memory across...
Tokens:2,027
Snippets:24
Trust Score:8.6
Update:8 months ago
Show doc for...
Tokens:
Raw
### Quick Install MCP Server

Source: https://supermemory.ai/docs/supermemory-mcp/mcp/index

Installs the MCP server using npx. Replace 'claude' with your desired client (e.g., 'cursor', 'windsurf', 'vscode').

```bash
npx -y install-mcp@latest https://mcp.supermemory.ai/mcp --client claude --oauth=yes
```

--------------------------------

### WhoAmI API

Source: https://supermemory.ai/docs/supermemory-mcp/mcp/index

Get the current logged-in user's information. This endpoint provides details about the authenticated user.

```APIDOC
## GET /whoami

### Description
Get the current logged-in user's information.

### Method
GET

### Endpoint
/whoami

### Response
#### Success Response (200)
- **userId** (string) - The unique identifier for the user
- **email** (string) - The user's email address
- **name** (string) - The user's name
- **client** (string) - The client used by the user
- **sessionId** (string) - The session ID for the current interaction

#### Response Example
```json
{
  "userId": "user-abc",
  "email": "user@example.com",
  "name": "John Doe",
  "client": "claude",
  "sessionId": "session-xyz"
}
```
```

--------------------------------

### Recall Memories API

Source: https://supermemory.ai/docs/supermemory-mcp/mcp/index

Search memories and get user profile. This tool allows for querying stored memories and optionally retrieving a summary of the user's profile.

```APIDOC
## POST /tools/recall

### Description
Search memories and get user profile.

### Method
POST

### Endpoint
/tools/recall

### Parameters
#### Request Body
- **query** (string) - Required - Search query to find relevant memories
- **includeProfile** (boolean) - Optional - Include user profile summary. Default: true
- **containerTag** (string) - Optional - Project tag to scope the search

### Request Example
```json
{
  "query": "What are the user's main interests?",
  "includeProfile": true,
  "containerTag": "project-123"
}
```

### Response
#### Success Response (200)
- **memories** (array) - List of relevant memories found
- **profile** (object) - User profile summary (if includeProfile is true)

#### Response Example
```json
{
  "memories": [
    "User enjoys science fiction movies."
  ],
  "profile": {
    "userId": "user-abc",
    "preferences": {"theme": "dark"}
  }
}
```
```

--------------------------------

### Context Prompt API

Source: https://supermemory.ai/docs/supermemory-mcp/mcp/index

Inject user profile and preferences as system context for AI conversations. This prompt formats user data for use as system context in LLM interactions.

```APIDOC
## POST /prompts/context

### Description
Inject user profile and preferences as system context for AI conversations.

### Method
POST

### Endpoint
/prompts/context

### Parameters
#### Request Body
- **containerTag** (string) - Optional - Project tag to scope the profile (max 128 chars)
- **includeRecent** (boolean) - Optional - Include recent activity in the profile. Default: true

### Request Example
```json
{
  "containerTag": "project-123",
  "includeRecent": true
}
```

### Response
#### Success Response (200)
- **systemContext** (string) - Formatted system message including instructions, stable preferences, and recent activity.

#### Response Example
```json
{
  "systemContext": "You are an AI assistant. Instructions: Save new memories using the memory tool. Stable Preferences: User prefers dark mode. Recent Activity: User asked about their interests."
}
```
```

--------------------------------

### Manual Configuration - Default

Source: https://supermemory.ai/docs/supermemory-mcp/mcp/index

Adds the Supermemory MCP server configuration to your client. Uses OAuth for authentication by default.

```json
{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp"
    }
  }
}
```

--------------------------------

### Manual Configuration - Project Scoping

Source: https://supermemory.ai/docs/supermemory-mcp/mcp/index

Scopes all MCP operations to a specific project by providing the project ID in the `x-sm-project` header.

```json
{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp",
      "headers": {
        "x-sm-project": "your-project-id"
      }
    }
  }
}
```

--------------------------------

### Manual Configuration - API Key Authentication

Source: https://supermemory.ai/docs/supermemory-mcp/mcp/index

Configures the MCP client to use an API key for authentication instead of OAuth. Obtain your API key from app.supermemory.ai.

```json
{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp",
      "headers": {
        "Authorization": "Bearer sm_your_api_key_here"
      }
    }
  }
}
```

--------------------------------

### Memory Management API

Source: https://supermemory.ai/docs/supermemory-mcp/mcp/index

Save or forget information about the user. This tool allows for managing user memories, with options to save new memories or forget existing ones.

```APIDOC
## POST /tools/memory

### Description
Save or forget information about the user.

### Method
POST

### Endpoint
/tools/memory

### Parameters
#### Request Body
- **content** (string) - Required - The memory content to save or forget
- **action** (string) - Optional - Allowed values: "save", "forget". Default: "save"
- **containerTag** (string) - Optional - Project tag to scope the memory

### Request Example
```json
{
  "content": "User prefers dark mode.",
  "action": "save",
  "containerTag": "project-123"
}
```

### Response
#### Success Response (200)
- **status** (string) - Indicates the success of the operation (e.g., "success")

#### Response Example
```json
{
  "status": "success"
}
```
```
Tokens:
Raw