@tages/server

The MCP server for Tages — team memory for AI coding agents.

This is the package your agent talks to. It speaks the Model Context Protocol over stdio and exposes Tages' memory tools (remember, recall, forget, observe, and the rest of a 56-tool surface) to any MCP-capable client: Claude Code, Cursor, Codex, Gemini CLI.

Reads are served from a local SQLite cache for sub-10ms lookups, with asynchronous sync to Supabase when cloud mode is configured.

Install

You normally do not install this by hand — you register it as an MCP server and let your client run it with npx:

claude mcp add tages -- npx -y @tages/server

The @tages/cli init command and the editor plugins (@tages/cursor-plugin, @tages/codex-plugin, @tages/gemini-plugin) write the equivalent config for you.

Configuration

The server runs local-only with zero configuration. For cloud and team mode, set:

| Variable | Purpose | |---|---| | TAGES_SUPABASE_URL | Supabase project URL | | TAGES_SUPABASE_ANON_KEY | Supabase anon key | | TAGES_PROJECT_ID | Project the agent should read and write | | TAGES_ENCRYPTION_KEY | Optional AES-256-GCM encryption of memory values at rest |

A manual MCP entry looks like:

{
  "mcpServers": {
    "tages": {
      "command": "npx",
      "args": ["-y", "@tages/server"],
      "env": { "TAGES_PROJECT_ID": "<uuid>" }
    }
  }
}

Links

• Repository and full documentation
• Issues

MIT licensed.