# Codex4ever

> Codex4ever is an open-source MCP server for developer tools. Local MCP server that plans OpenAI Codex weekly quota use and reset timing. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web
- **Website:** https://codex4ever.com
- **Repository:** https://github.com/itsodeleo/codex4ever
- **MCP Registry name:** io.github.ItsOdeLeo/codex4ever
- **Categories:** developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

Rather than showing a usage meter, it answers a planning question: at your current pace, when does the weekly quota run out, will an extra reset arrive first, and is a banked reset worth redeeming now. A two-week timeline lays out daily usage, run-out points, outages, normal refreshes and banked-reset uses.

Five strategies change the plan: keep pace, keep available, use it all, weekdays only and weekend focus. The extra-reset forecast gives the chance of an automatic reset in the next 48 hours, built from public reset history. A predicted reset is only counted when it is at least 60% likely, and the README calls the forecast an uncalibrated estimate rather than a promise. Every refill restarts the seven-day window, and the last banked reset is kept for a real outage of 24 hours or more.

It reads your local signed-in Codex quota in read-only mode and never redeems a reset or spends credits. The project was formerly called Codex4ever, is unofficial, and is MIT licensed. A browser version works with hand-entered numbers and sends nothing anywhere.

## Features

- **Two-week timeline:** Daily usage, run-out points, outages and refreshes per day.
- **Extra-reset forecast:** Probability of an automatic reset within 48 hours.
- **Five strategies:** Keep pace, keep available, use it all, weekdays only or weekend focus.
- **Banked reset advice:** Shows when a banked reset is worth redeeming.
- **Read-only quota access:** Reads local Codex quota without spending anything.
- **Same plan everywhere:** Website, plugin and MCP tools give identical plans.

## Good for

- See when this week's Codex quota will run out
- Decide whether to redeem a banked reset
- Compare usage strategies for the coming days
- Spread usage across weekdays only
- Get overuse reminders inside a Codex chat

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "codex4ever": {
      "command": "npx",
      "args": [
        "-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"
      ]
    }
  }
}
```

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

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

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

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

## FAQ

### Does it spend or redeem anything?

No. It never redeems a reset or spends credits.

### Does it need an API key?

No separate key; reading quota needs a signed-in Codex app or CLI.

### Can I use it without Codex?

The website works with hand-entered numbers, calculated in your browser.

### Is the forecast reliable?

It is an uncalibrated model estimate, not a promise.

### Is it official?

No, it is unofficial and not affiliated with OpenAI.

### Is Codex4ever free?

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

### How do I add Codex4ever to Claude Code?

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

### What are the best alternatives to Codex4ever?

The closest alternatives to Codex4ever 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.
- [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.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/codex4ever
