Gemdex MCP Server

by nikshipsio.github.nikships/gemdexv1.0.47

Persistent memory layer for AI coding agents: save, recall, update via Gemini plus LanceDB

4Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active3d ago

Install Gemdex MCP server

claude mcp add gemdex -e GEMINI_API_KEY='<gemini-api-key>' -e GEMDEX_REMOTE_TOKEN='<gemdex-remote-token>' -- npx -y gemdex-mcp

{
  "mcpServers": {
    "gemdex": {
      "command": "npx",
      "args": [
        "-y",
        "gemdex-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>",
        "GEMDEX_REMOTE_TOKEN": "<gemdex-remote-token>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "gemdex": {
      "command": "npx",
      "args": [
        "-y",
        "gemdex-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>",
        "GEMDEX_REMOTE_TOKEN": "<gemdex-remote-token>"
      }
    }
  }
}

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

{
  "servers": {
    "gemdex": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gemdex-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>",
        "GEMDEX_REMOTE_TOKEN": "<gemdex-remote-token>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "gemdex": {
      "command": "npx",
      "args": [
        "-y",
        "gemdex-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>",
        "GEMDEX_REMOTE_TOKEN": "<gemdex-remote-token>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
GEMINI_API_KEY	yes	yes	Google AI Studio key for local mode, or the exact value 'local' for on-device MLX text embeddings. Not needed in remote mode.
GEMDEX_MODE	—	—	Memory backend: embedded local LanceDB or a self-hosted Gemdex Server
LANCEDB_PATH	—	—	Directory for the embedded LanceDB store
EMBEDDING_MODEL	—	—	Gemini text embedding model
GEMDEX_REMOTE_URL	—	—	Gemdex Server root URL (required in remote mode)
GEMDEX_REMOTE_TOKEN	—	yes	Gemdex Server bearer token (required in remote mode)
GEMDEX_REMOTE_NAME	—	—	Human-readable name for the remote server
GEMDEX_TRUST_RANKING	—	—	Re-rank recall results by recorded worked/failed/stale outcomes

Freshness

Active — last maintenance signal 3d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-06 · 3d ago · GitHub
Latest release
2026-10-06 · 3d ago · GitHub · v1.0.49
Package published
no data · npm/PyPI
Registry entry updated
2026-09-23 · 17d ago · official registry · v1.0.47

FAQ

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

Run: claude mcp add gemdex -e GEMINI_API_KEY='<gemini-api-key>' -e GEMDEX_REMOTE_TOKEN='<gemdex-remote-token>' -- npx -y gemdex-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Gemdex require an API key?

Yes. It expects GEMINI_API_KEY, GEMDEX_REMOTE_TOKEN, of which 2 are secrets.

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

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

›Is Gemdex in the official MCP registry?

Yes, as io.github.nikships/gemdex.