@vemdev/mcp-server

Official VEM MCP Server — gives AI agents (Claude, Cursor, Copilot, etc.) durable project memory via the Model Context Protocol.

Agents can read tasks, record decisions, search context, and sync snapshots to the cloud — all through structured MCP tools.

Quick start

npx @vemdev/mcp-server@latest --api-key <your-api-key>

Get your API key from app.vem.dev → Settings → API Keys.

Related MCP server: LogicMem MCP Server

MCP host configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "vem": {
      "command": "npx",
      "args": ["@vemdev/mcp-server@latest", "--api-key", "nk_your_key_here"]
    }
  }
}

Cursor / VS Code

Add to your MCP settings:

{
  "vem": {
    "command": "npx",
    "args": ["@vemdev/mcp-server@latest", "--api-key", "nk_your_key_here"]
  }
}

Authentication

There are three ways to provide your API key, in priority order:

1. --api-key flag (recommended for MCP hosts)

Pass the key directly when starting the server:

npx @vemdev/mcp-server@latest --api-key nk_your_key_here

The key is saved to ~/.vem/config.json on first run, so subsequent starts without the flag will reuse it automatically.

2. VEM_API_KEY environment variable

Useful in CI or when you prefer not to store the key on disk:

VEM_API_KEY=nk_your_key_here npx @vemdev/mcp-server@latest

Or in your MCP host config:

{
  "mcpServers": {
    "vem": {
      "command": "npx",
      "args": ["@vemdev/mcp-server@latest"],
      "env": {
        "VEM_API_KEY": "nk_your_key_here"
      }
    }
  }
}

3. vem login CLI (if you already use the CLI)

If you have the VEM CLI installed and have already logged in, the MCP server picks up the saved key automatically — no extra config needed:

npx @vemdev/cli@latest login nk_your_key_here
npx @vemdev/mcp-server@latest   # key is read from ~/.vem/config.json

Getting an API key

1. Go to app.vem.dev and sign in

2. Navigate to Settings → API Keys

3. Click Create key and copy the nk_... token

4. Pass it to the server via any of the methods above

Available tools

Environment variables

License

MIT