Agent Magnet MCP Server

by helinakdoganio.github.helinakdogan/agent-magnetv0.1.11

Behavioral memory layer for AI tools. Learns preferences and context across Claude, Cursor, Codex.

14Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained34d ago

Install Agent Magnet MCP server

claude mcp add agent-magnet -e MAGNET_USER_ID='<magnet-user-id>' -- uvx agent-magnet

{
  "mcpServers": {
    "agent-magnet": {
      "command": "uvx",
      "args": [
        "agent-magnet"
      ],
      "env": {
        "MAGNET_USER_ID": "<magnet-user-id>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "agent-magnet": {
      "command": "uvx",
      "args": [
        "agent-magnet"
      ],
      "env": {
        "MAGNET_USER_ID": "<magnet-user-id>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "agent-magnet": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "agent-magnet"
      ],
      "env": {
        "MAGNET_USER_ID": "<magnet-user-id>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "agent-magnet": {
      "command": "uvx",
      "args": [
        "agent-magnet"
      ],
      "env": {
        "MAGNET_USER_ID": "<magnet-user-id>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MAGNET_USER_ID	yes	—	Your identifier used as the memory key across all tools
MAGNET_OPENAI_KEY	—	—	OpenAI API key for the reflector and classifier models
MAGNET_LOCAL_MODE	—	—	Set to 1 to use local SQLite storage — no Redis or external services needed
MAGNET_REDIS_URL	—	—	Redis connection URL for persistent shared storage (overrides local mode)
MAGNET_PROJECT_ID	—	—	Namespace for memory isolation across projects (defaults to 'default')

Freshness

Maintained — last maintenance signal 34d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-05 · 34d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-06-18 · 4mo ago · official registry · v0.1.11

FAQ

›How do I install the Agent Magnet MCP server in Claude Code?

Run: claude mcp add agent-magnet -e MAGNET_USER_ID='<magnet-user-id>' -- uvx agent-magnet. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Agent Magnet require an API key?

Yes. It expects MAGNET_USER_ID.

›Can I use Agent Magnet as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Agent Magnet in the official MCP registry?

Yes, as io.github.helinakdogan/agent-magnet.