# Token Savior MCP server

> Navigate codebases by symbol and keep persistent memory across sessions to cut tokens spent on reading code.

- Listing: https://mcp.tc/i/token-savior
- Connect: this is a local (stdio) server; install it on your machine (see Install). The listing link is a page, not an MCP endpoint.
- Type: local (stdio)
- Auth: no API key needed
- Category: [Developer Tools](https://mcp.tc/c/developer-tools)
- Vendor: Mibayy
- Homepage: <https://mibayy.github.io/token-savior/>
- Repository: <https://github.com/Mibayy/token-savior>
- Package: pypi `token-savior-recall`

## About

Token Savior indexes the project roots you give it and lets an AI coding agent navigate by symbol, search code with the enclosing function shown for each hit, and recall notes across sessions. It can also compact and rewrite Bash command output through optional hooks for Claude Code, Cursor, Gemini and Codex.

It runs locally over stdio as the PyPI package token-savior-recall, started with uvx. No sign-in is needed. Set WORKSPACE\_ROOTS to the project paths to index. An Anthropic API key is only needed for the optional LLM memory auto-extraction.

## What it can do

- Navigate source code by symbol instead of reading whole files
- Search the codebase with the enclosing function named for each hit
- Keep persistent memory that can be recalled across sessions
- Optionally compact Bash output with 34 compactors
- Optionally rewrite Bash commands before they run
- Choose a tool manifest size with the profile setting

## Example prompts

- "Find where the payment handler function is defined and show only that symbol"
- "Search the codebase for uses of the retry decorator"
- "Recall what we decided about the database schema last session"
- "Index my two project folders and list the main modules"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport stdio token-savior --env "WORKSPACE_ROOTS=<YOUR_WORKSPACE_ROOTS>" -- uvx token-savior-recall
```

2. Start Claude Code and type `/mcp`. **token-savior** should show as connected.

Add `--scope user` to make it available in every project. Replace the placeholders with your own values.

### Claude Desktop

1. Open **Settings → Developer → Edit Config**. It opens `claude_desktop_config.json`. Add:

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "token-savior": {
      "command": "uvx",
      "args": [
        "token-savior-recall"
      ],
      "env": {
        "WORKSPACE_ROOTS": "<YOUR_WORKSPACE_ROOTS>"
      }
    }
  }
}
```

2. Save the file and restart Claude Desktop. Replace the placeholders with your own values.

Needs uv (Python) on your computer. The file lives in `~/Library/Application Support/Claude/` on macOS and `%APPDATA%\Claude\` on Windows.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=token-savior&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJ0b2tlbi1zYXZpb3ItcmVjYWxsIl0sImVudiI6eyJXT1JLU1BBQ0VfUk9PVFMiOiI8WU9VUl9XT1JLU1BBQ0VfUk9PVFM%2BIn19>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "token-savior": {
      "command": "uvx",
      "args": [
        "token-savior-recall"
      ],
      "env": {
        "WORKSPACE_ROOTS": "<YOUR_WORKSPACE_ROOTS>"
      }
    }
  }
}
```

Needs uv (Python) on your computer. Replace the placeholders with your own values.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=token-savior&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22token-savior-recall%22%5D%2C%22env%22%3A%7B%22WORKSPACE_ROOTS%22%3A%22%3CYOUR_WORKSPACE_ROOTS%3E%22%7D%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"token-savior","type":"stdio","command":"uvx","args":["token-savior-recall"],"env":{"WORKSPACE_ROOTS":"<YOUR_WORKSPACE_ROOTS>"}}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "token-savior": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "token-savior-recall"
      ],
      "env": {
        "WORKSPACE_ROOTS": "<YOUR_WORKSPACE_ROOTS>"
      }
    }
  }
}
```

Needs uv (Python) on your computer.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "token-savior": {
      "command": "uvx",
      "args": [
        "token-savior-recall"
      ],
      "env": {
        "WORKSPACE_ROOTS": "<YOUR_WORKSPACE_ROOTS>"
      }
    }
  }
}
```

2. Refresh the MCP server list in Cascade. Replace the placeholders with your own values.

Devin Desktop is the new name for Windsurf.

### Codex

```bash
codex mcp add token-savior --env "WORKSPACE_ROOTS=<YOUR_WORKSPACE_ROOTS>" -- uvx token-savior-recall
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.token-savior]
command = "uvx"
args = ["token-savior-recall"]
env = { WORKSPACE_ROOTS = "<YOUR_WORKSPACE_ROOTS>" }
```

Needs uv (Python) on your computer. Replace the placeholders with your own values.

### Gemini CLI

```bash
gemini mcp add -e "WORKSPACE_ROOTS=<YOUR_WORKSPACE_ROOTS>" token-savior uvx token-savior-recall
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients that start local servers accept this shape:

```json
{
  "mcpServers": {
    "token-savior": {
      "command": "uvx",
      "args": [
        "token-savior-recall"
      ],
      "env": {
        "WORKSPACE_ROOTS": "<YOUR_WORKSPACE_ROOTS>"
      }
    }
  }
}
```

Zed puts servers under `context_servers` in its settings, with the same `command`, `args` and `env` fields.

Needs uv (Python) on your computer. Replace the placeholders with your own values.

## Recent changes

- 2026-10-15 13:23 UTC: New version 4.24.0 (was 4.23.2), read from PyPI. Source: automatic check.
- 2026-10-09 04:21 UTC: Tracking started: version 4.23.2. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/token-savior#history (Atom feed: https://mcp.tc/i/token-savior/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 4.24.0
- Last checked: 2026-10-09
- Listed: 2026-10-09
- Updated: 2026-10-09

---
Source: https://mcp.tc/i/token-savior (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
