mcpbeat Sign in

Gemdex MCP Server

local only

Gemdex runs on your own machine — the client starts it, so there is no endpoint to ping. 66 installs a week from npm. Last commit 22 Oct 2026.

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

Installs per day peak 412 · avg 40 · -62% w/w
a month agotoday
66
Installs / week
npm · gemdex-mcp
5
Stars
5 open issues
22 Oct 2026
Last commit
6 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 3 h ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

        const child = spawn(command, args, {
Builds a file path from a variable packages/server/integration/byoi.mjs:232
        const blobFiles = await fs.readdir(path.join(blobDir, memoryId), { recursive: true });
Reads files and sends them to the network packages/server/integration/byoi.mjs:232
        const blobFiles = await fs.readdir(path.join(blobDir, memoryId), { recursive: true });

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add gemdex -e 'GEMINI_API_KEY=<GEMINI_API_KEY>' -- npx -y gemdex-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "gemdex": {
      "command": "npx",
      "args": [
        "-y",
        "gemdex-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.gemdex]
command = "npx"
args = ["-y", "gemdex-mcp"]
env = { GEMINI_API_KEY = "<GEMINI_API_KEY>" }
.cursor/mcp.json
{
  "mcpServers": {
    "gemdex": {
      "command": "npx",
      "args": [
        "-y",
        "gemdex-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "gemdex": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gemdex-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Put your own value in place of <GEMINI_API_KEY> (Google AI Studio key for local mode, or the exact value 'local' for on-device MLX text embeddings. Not needed in remote mode). The author’s registry entry marks it as required.

Optional settings from the registry entry, left out of the block above: 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 (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).

Alternatives to Gemdex

same job, measured the same way
Agentos
by officialtanishsharma

Local-first persistent memory MCP server for AI coding agents.

local only
PMB AI
by oleksiijko

Local-first persistent memory for AI coding agents.

205 installs/wk local only
aide-memory
by aide-memory

Persistent memory layer for AI coding agents — your agent remembers what you taught it.

65 installs/wk local only
Norn
by samad001z

Local-first, persistent memory for AI coding agents — remember, recall, forget, and list, over MCP.

61 installs/wk local only
Aidimag
by aidimag

Persistent, verified memory for AI coding agents: recall, capture, guardrails, review queue.

local only
Mindtrail
by rohitdeshmukh-1

Persistent, local-first memory for AI coding agents. Remember, recall and forget across sessions.

97 installs/wk local only
Montycat MCP - Shared Memory for AI Agents
by montygovernance

Shared, persistent memory for AI agents, with semantic recall and live updates.

239 installs/wk local only
memry
by mrtheroi

Persistent memory for AI coding agents. Install the memry CLI and run memry setup.

local only

Gemdex — questions

Answers built from our own checks of this server.

Why is there no uptime for Gemdex?
Gemdex runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package gemdex-mcp was installed 66 times last week.
How do I connect Gemdex?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls gemdex-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use Gemdex?
The npm package gemdex-mcp was installed 66 times in the last week. Week over week that is -62%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Gemdex open source?
Yes — it is published under the MIT licence, written in TypeScript, 5 stars on GitHub and 5 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.