# Usage Planner MCP server

> Plans OpenAI Codex weekly quota usage by forecasting extra resets and managing banked resets through various usage strategies.

- Repository: https://github.com/ItsOdeLeo/codex4ever
- Page: https://hostedmcp.org/servers/itsodeleo/codex4ever
- Transport: stdio
- Stars: 5
- License: MIT
- Latest version: 0.1.3

## Install

### Claude Code

```sh
claude mcp add codex4ever -- npx -y codex4ever
```

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

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

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

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

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.codex4ever]
command = "npx"
args = ["-y", "codex4ever"]
```

### Gemini CLI (`~/.gemini/settings.json`)

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

## FAQ

### How does the extra-reset forecast work?

It calculates the chance of an automatic reset in the next 48 hours based on public reset history and social media posts, counting it only if it is at least 60% likely.

### What usage strategies are available?

The planner offers five strategies: Keep pace, Keep available, Use it all, Weekdays only, and Weekend focus.