Toon Memory MCP Server

Name: Toon Memory MCP Server
Author: io.github.LuiggiVal08

io.github.LuiggiVal08/toon-memory

Repository Registry

What is the Toon Memory MCP server?

Offline persistent memory for AI coding agents — 35 tools, 80% fewer calls, no LLM

How to install Toon Memory

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

TOON_MEMORY_KEY
secret
Encryption key for AES-256-GCM memory encryption
TOON_MEMORY_CAPTURE
Set to 'true' to enable activity capture hooks
TOON_MEMORY_SESSION_ID
Override the auto-detected session ID
TOON_MEMORY_BRANCH
Override the auto-detected git branch name
TOON_MEMORY_NO_SESSION
Set to disable session heartbeat tracking
GITHUB_TOKEN
secret
GitHub personal access token for exporting/importing memory to Gist

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "toon-memory": {
      "command": "npx",
      "args": [
        "-y",
        "toon-memory",
        "mcp"
      ],
      "env": {
        "TOON_MEMORY_KEY": "<YOUR_TOON_MEMORY_KEY>",
        "TOON_MEMORY_CAPTURE": "<YOUR_TOON_MEMORY_CAPTURE>",
        "TOON_MEMORY_SESSION_ID": "<YOUR_TOON_MEMORY_SESSION_ID>",
        "TOON_MEMORY_BRANCH": "<YOUR_TOON_MEMORY_BRANCH>",
        "TOON_MEMORY_NO_SESSION": "<YOUR_TOON_MEMORY_NO_SESSION>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "toon-memory": {
      "command": "npx",
      "args": [
        "-y",
        "toon-memory",
        "mcp"
      ],
      "env": {
        "TOON_MEMORY_KEY": "<YOUR_TOON_MEMORY_KEY>",
        "TOON_MEMORY_CAPTURE": "<YOUR_TOON_MEMORY_CAPTURE>",
        "TOON_MEMORY_SESSION_ID": "<YOUR_TOON_MEMORY_SESSION_ID>",
        "TOON_MEMORY_BRANCH": "<YOUR_TOON_MEMORY_BRANCH>",
        "TOON_MEMORY_NO_SESSION": "<YOUR_TOON_MEMORY_NO_SESSION>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "toon-memory": {
      "command": "npx",
      "args": [
        "-y",
        "toon-memory",
        "mcp"
      ],
      "env": {
        "TOON_MEMORY_KEY": "<YOUR_TOON_MEMORY_KEY>",
        "TOON_MEMORY_CAPTURE": "<YOUR_TOON_MEMORY_CAPTURE>",
        "TOON_MEMORY_SESSION_ID": "<YOUR_TOON_MEMORY_SESSION_ID>",
        "TOON_MEMORY_BRANCH": "<YOUR_TOON_MEMORY_BRANCH>",
        "TOON_MEMORY_NO_SESSION": "<YOUR_TOON_MEMORY_NO_SESSION>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "toon-memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "toon-memory",
        "mcp"
      ],
      "env": {
        "TOON_MEMORY_KEY": "<YOUR_TOON_MEMORY_KEY>",
        "TOON_MEMORY_CAPTURE": "<YOUR_TOON_MEMORY_CAPTURE>",
        "TOON_MEMORY_SESSION_ID": "<YOUR_TOON_MEMORY_SESSION_ID>",
        "TOON_MEMORY_BRANCH": "<YOUR_TOON_MEMORY_BRANCH>",
        "TOON_MEMORY_NO_SESSION": "<YOUR_TOON_MEMORY_NO_SESSION>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}

Claude Code

claude mcp add toon-memory --env TOON_MEMORY_KEY=<YOUR_TOON_MEMORY_KEY> --env TOON_MEMORY_CAPTURE=<YOUR_TOON_MEMORY_CAPTURE> --env TOON_MEMORY_SESSION_ID=<YOUR_TOON_MEMORY_SESSION_ID> --env TOON_MEMORY_BRANCH=<YOUR_TOON_MEMORY_BRANCH> --env TOON_MEMORY_NO_SESSION=<YOUR_TOON_MEMORY_NO_SESSION> --env GITHUB_TOKEN=<YOUR_GITHUB_TOKEN> -- npx -y toon-memory mcp