# Usage Planner

> Usage Planner is an open-source MCP server for developer tools. Plan your OpenAI Codex weekly quota: run-out dates, banked resets and extra-reset odds. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, CLI
- **Website:** https://usageplanner.com
- **Repository:** https://github.com/itsodeleo/usage-planner
- **MCP Registry name:** io.github.ItsOdeLeo/usage-planner
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-15

## About

Usage Planner, formerly called Codex4ever, is an unofficial MIT-licensed planner that is not affiliated with OpenAI. It shows when your Codex weekly quota will run out at the current pace, whether a predicted extra reset is likely to arrive first, and when a banked reset is worth redeeming. A two-week timeline shows daily usage, remaining quota, outages, refreshes and banked-reset uses.

Five strategies change the plan: keep pace, keep available, use it all, weekdays only and weekend focus. A predicted reset is counted only when it is at least 60% likely before the next refresh, and it is placed conservatively in time. Every refill restarts the seven-day window, and the last banked reset is kept for a real outage of 24 hours or more. The extra-reset forecast is an uncalibrated model estimate built from public reset history and public posts, not a promise.

The MCP server runs from npm over stdio, but reading your quota needs a signed-in Codex CLI on the same machine; the read is local and read-only. The website works with hand-entered numbers calculated in your browser. The tool never redeems a reset or spends credits for you.

## Features

- **Two-week timeline:** Shows daily usage, remaining quota, run-out points, outages, refreshes and banked-reset uses.
- **Extra-reset forecast:** Estimates the chance and likely window of an automatic reset in the next 48 hours.
- **Five usage strategies:** Compares keeping pace, keeping quota available, using it all, weekdays only and weekend focus.
- **Banked reset advice:** Suggests when to redeem a banked reset and keeps the last one for an outage.
- **Overuse alerts:** The Codex plugin can remind you in the conversation when you exceed the plan.
- **Same plan everywhere:** The website, plugin page and MCP tools give the same plan for the same inputs.

## Good for

- See when this week's Codex quota will run out
- Decide whether to wait for a possible extra reset
- Pick the best moment to redeem a banked reset
- Compare weekday-only and weekend-focus usage plans
- Ask Codex to open the planner beside the chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add usage-planner -- npx -y usage-planner
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "usage-planner": {
      "command": "npx",
      "args": [
        "-y",
        "usage-planner"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "usage-planner": {
      "command": "npx",
      "args": [
        "-y",
        "usage-planner"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "usage-planner": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "usage-planner"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "usage-planner": {
      "command": "npx",
      "args": [
        "-y",
        "usage-planner"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "usage-planner": {
      "command": "npx",
      "args": [
        "-y",
        "usage-planner"
      ]
    }
  }
}
```

## FAQ

### Does it need my credentials?

No separate API key. Reading quota is local and read-only through a signed-in Codex app or CLI.

### Can it redeem resets for me?

No. The README says it never redeems a reset or spends credits.

### How reliable is the forecast?

It is described as an uncalibrated model estimate, not a promise.

### Can I use it without installing anything?

Yes. The website works in the browser, with quota entered by hand and nothing sent anywhere.

### Is Usage Planner free?

Yes. Usage Planner is open source, so you can use and self-host it for free.

### How do I add Usage Planner to Claude Code?

Run this command in your terminal: claude mcp add usage-planner -- npx -y usage-planner

### What are the best alternatives to Usage Planner?

The closest alternatives to Usage Planner are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/usage-planner
