Skip to main content
Glama
jfreels123

supermemory-stdio-mcp

by jfreels123

Supermemory Stdio MCP Server

A stdio-based MCP (Model Context Protocol) server that wraps Supermemory's REST API.

Why? Supermemory's official MCP uses HTTP transport which doesn't work well with some MCP clients (like Factory/Droid). This server uses stdio transport which is more universally compatible.

Features

  • šŸ”Œ Stdio transport - Works with Factory/Droid, Claude Desktop, Cursor, etc.

  • šŸ’¾ Persistent memory - Save and recall information across sessions

  • šŸ” Semantic search - Find relevant memories using natural language

  • šŸ‘¤ User profiles - Auto-generated profiles from stored memories

  • šŸ·ļø Project scoping - Organize memories by project

Related MCP server: mem0-mcp

Installation

git clone https://github.com/YOUR_USERNAME/supermemory-stdio-mcp.git
cd supermemory-stdio-mcp
npm install
npm run build

Configuration

Get your API Key

  1. Go to console.supermemory.ai

  2. Create an account and generate an API key (starts with sm_)

Factory/Droid

Add to ~/.factory/mcp.json:

{
  "mcpServers": {
    "supermemory": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/supermemory-stdio-mcp/dist/index.js"],
      "env": {
        "SUPERMEMORY_API_KEY": "sm_your_api_key_here",
        "SUPERMEMORY_PROJECT": "your-project-name"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "supermemory": {
      "command": "node",
      "args": ["/path/to/supermemory-stdio-mcp/dist/index.js"],
      "env": {
        "SUPERMEMORY_API_KEY": "sm_your_api_key_here",
        "SUPERMEMORY_PROJECT": "your-project-name"
      }
    }
  }
}

Tools

memory

Save or forget information about the user.

{
  "content": "User prefers dark mode and uses TypeScript",
  "action": "save"
}

Parameter

Type

Required

Description

content

string

Yes

The information to save or forget

action

"save" | "forget"

No

Default: "save"

recall

Search memories and get user profile.

{
  "query": "What are the user's programming preferences?",
  "includeProfile": true
}

Parameter

Type

Required

Description

query

string

Yes

Search query to find relevant memories

includeProfile

boolean

No

Include user profile (default: true)

Environment Variables

Variable

Required

Description

SUPERMEMORY_API_KEY

Yes

Your Supermemory API key (starts with sm_)

SUPERMEMORY_PROJECT

No

Project name to scope memories (default: "default")

Development

# Run in development mode (with hot reload)
npm run dev

# Build for production
npm run build

# Run production build
npm start

How It Works

ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”     stdio      ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
│   MCP Client    │◄──────────────►│  This MCP Server    │
│ (Factory/Droid) │                │  (stdio transport)  │
ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜                ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜
                                              │
                                              │ REST API
                                              ā–¼
                                   ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
                                   │   Supermemory API   │
                                   │ (api.supermemory.ai)│
                                   ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜

License

MIT

Credits

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    A server that wraps a self-hosted mem0 REST API as MCP tools for Claude Desktop and Claude Code, enabling memory operations such as adding, searching, and managing memories via natural language.
    6
    1
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    A thin stdio MCP bridge to a self-hosted mem0 OSS server for agent memory, enabling persistent memory operations like adding, searching, and managing durable facts with automatic reconciliation and question-rewrite capabilities.
    1
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    A fully local, persistent memory layer for AI agents that runs as an MCP stdio server and provides an AI SDK adapter for seamless integration with generateText/streamText agents.
    4
    1
    MIT