Skip to main content
Glama
Sign In
supermemory-stdio-mcp

supermemory-stdio-mcp

by jfreels123
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mem0-mcp

      andresmorales07
      A
      license
      A
      quality
      C
      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

    • mem0-mcp

      krim404
      A
      license
      Not graded
      quality
      D
      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
      MIT

    • memkit

      iamanishx
      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.
      3 npm
      1
      MIT