Supermemory MCP server

Personal knowledge platform that helps collect, organize, and recall information from various sources with end-to-end encryption and optional self-hosting.
Back to servers
Setup instructions
Provider
Dhravya Shah
Release date
Feb 27, 2024
Language
TypeScript
Stats
13.5K stars

Supermemory MCP serves as an AI second brain for saving and organizing everything that matters. This server provides integration between your saved memories and AI tools through the Model Context Protocol (MCP), allowing you to access and interact with your stored knowledge across various platforms.

Installation and Setup

Prerequisites

To use Supermemory MCP, you'll need:

  • A Supermemory account
  • Access to the Supermemory web application
  • Optional: Chrome browser for the extension or Raycast for the Raycast extension

Getting Started

  1. Visit the Supermemory web application at app.supermemory.ai and sign in with your account.

  2. For browser integration, install the Chrome extension from the Chrome Web Store: Supermemory Chrome Extension

  3. For Raycast users, install the Raycast extension: Supermemory Raycast Extension

Usage Guide

Adding Memories

Supermemory supports various formats for adding memories:

  1. From the Web App:

    • Click on "Add Memory" and choose your preferred format (Note, Link, File)
    • For URLs, simply paste the link
    • For PDFs, upload the file
    • For plain text, paste or type your content
  2. Connect External Services: You can integrate with services like:

    • Notion
    • Google Drive
    • OneDrive

Chatting with Your Memories

Once you've added memories to your Supermemory:

  1. Click on "Open Chat" in the web interface
  2. Ask questions in natural language
  3. Supermemory will retrieve relevant information from your saved memories

MCP Integration

To connect Supermemory to your AI tools via Model Context Protocol:

  1. In the Supermemory web app, click on "Connect to your AI"
  2. Select the AI tool you want to integrate with (supports Claude, Cursor, and others)
  3. Follow the on-screen instructions to complete the connection

Browser Extension

The Chrome extension enhances your Supermemory experience:

  • Save memories from any webpage with right-click or extension popup
  • Integrate with ChatGPT and Claude conversations
  • Import content from Twitter/X

Raycast Extension

For Raycast users, the extension provides keyboard shortcuts:

Add Memory - Quickly save content
Search Memories - Find and retrieve saved information

Support and Troubleshooting

If you encounter any issues or have questions:

Additional Resources

For developers and enterprise users:

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "supermemory" '{"command":"npx","args":["-y","supermemory"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "supermemory": {
            "command": "npx",
            "args": [
                "-y",
                "supermemory"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "supermemory": {
            "command": "npx",
            "args": [
                "-y",
                "supermemory"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect

Want to 10x your AI skills?

Get a free account and learn to code + market your apps using AI (with or without vibes!).

Nah, maybe later