English Français العربية

seatledger

Official registry Developer tools

Local ledger of Claude Code and Codex tokens, API-equivalent cost, limits and token-rate changes.

Source code Website

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package seatledger
Claude Code 
claude mcp add seatledger -e 'CLAUDE_CONFIG_DIR=<CLAUDE_CONFIG_DIR>' -e 'CODEX_HOME=<CODEX_HOME>' -e 'SEATLEDGER_HOME=<SEATLEDGER_HOME>' -e 'SEATLEDGER_KEY=<your seatledger_key>' -- npx -y seatledger@0.3.0 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "seatledger": {
            "command": "npx",
            "args": [
                "-y",
                "seatledger@0.3.0",
                "mcp"
            ],
            "env": {
                "CLAUDE_CONFIG_DIR": "<CLAUDE_CONFIG_DIR>",
                "CODEX_HOME": "<CODEX_HOME>",
                "SEATLEDGER_HOME": "<SEATLEDGER_HOME>",
                "SEATLEDGER_KEY": "<your seatledger_key>"
            }
        }
    }
}

Environment variables

  • CLAUDE_CONFIG_DIR Claude Code's config directory, if not ~/.claude; transcripts are read from its projects/ folder
  • CODEX_HOME Codex's home directory, if not ~/.codex; rollouts are read from its sessions/ folder
  • SEATLEDGER_HOME Where seatledger keeps your limits and its cache of counts (default ~/.seatledger)
  • SEATLEDGER_KEY secret Team ledger push key for seatledger_team_summary, if not saved by `seatledger team join` or `team create`

Frequently asked questions

What is seatledger?

Local ledger of Claude Code and Codex tokens, API-equivalent cost, limits and token-rate changes.

How do I install seatledger?

It runs on your machine. In Claude Code: claude mcp add seatledger -e 'CLAUDE_CONFIG_DIR=<CLAUDE_CONFIG_DIR>' -e 'CODEX_HOME=<CODEX_HOME>' -e 'SEATLEDGER_HOME=<SEATLEDGER_HOME>' -e 'SEATLEDGER_KEY=<your seatledger_key>' -- npx -y seatledger@0.3.0 mcp. For other clients, paste the JSON configuration from this page into their MCP settings.

Does seatledger need an API key?

Yes. It expects SEATLEDGER_KEY, which you set in its configuration.

Is seatledger open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains seatledger?

It is published by agentwares. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.