planlimits
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@planlimitscheck my Claude Code and Codex usage and tell me which plan to use next"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
planlimits
Free tools for checking AI coding plan limits: a local CLI and MCP servers for PlanLimits.
MCP docs: https://planlimits.app/mcp-docs/
Free tools
CLI (
planlimits): reads your local Claude Code and Codex CLI logs, shows usage, state and reset times per plan, and tells you which plan to use next.Local MCP server (
planlimits mcp): exposesget_my_usageandroute_meto your agent over stdio.Remote MCP server (
https://planlimits.app/mcp): read-only plan data, no auth:list_plans,get_tool_plans,get_recent_changes,recommend_plan,route_task.
Related MCP server: Claude Code Bridge
Install and run the CLI
Requires Node 18+. Zero dependencies.
npx https://planlimits.app/cli/planlimits.tgz statusOr from this repo:
git clone https://github.com/rpatel021/planlimits-mcp
cd planlimits-mcp
node bin/planlimits.mjs status # or: npm link, then planlimits statusCommands:
planlimits status [--json] usage, state and resets per plan
planlimits route [--task refactor|everyday|quick] [--offline] [--json]
planlimits mcp [--offline] local stdio MCP server
planlimits watch [--threshold 80] [--interval 60] [--once] [--no-desktop] [--json]
planlimits init write a ~/.planlimits.json template
planlimits hook install|uninstall claude-code [--yes]
planlimits handoff codex [--print]Logs read: ~/.claude/projects, ~/.config/claude/projects or $CLAUDE_CONFIG_DIR; $CODEX_HOME/sessions or ~/.codex/sessions.
Privacy: online route sends only plan ids, states and task to planlimits.app/api/v1/route. --offline (or PLANLIMITS_OFFLINE=1) sends nothing. watch never uses the network. Codex percentages are server-reported; Claude Code percentages are estimates against your own thresholds in ~/.planlimits.json, since Anthropic publishes no token limits.
Tests: bash test/run-tests.sh (uses temporary HOME directories).
Connect the MCP server
Remote (plan data):
claude mcp add --transport http planlimits https://planlimits.app/mcpCursor ~/.cursor/mcp.json:
{ "mcpServers": { "planlimits": { "url": "https://planlimits.app/mcp" } } }Local (your own usage):
claude mcp add planlimits-local -- npx -y https://planlimits.app/cli/planlimits.tgz mcpCodex, curl testing and more: docs/mcp-server.md and https://planlimits.app/mcp-docs/.
License
MIT. See LICENSE.
This server cannot be deployed
Maintenance
Related MCP Connectors
Source-checked CLI guides and model-aware planning for Claude Code, Codex, and Grok Build.
AI coding plan limits (Claude Code, Codex, Cursor, Copilot): router, picker, status, budget check
Cross-agent artifact workspace with provenance across Claude Code, Codex, Cursor, LangGraph.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Related MCP Servers
- AlicenseCqualityFmaintenanceConnects AI assistants like Claude to the Codex CLI for code analysis, editing, and execution. Supports file references with @ syntax, sandboxed code execution with approval workflows, and structured code changes for automated refactoring and documentation.842 npm176MIT
- AlicenseNot gradedqualityAmaintenanceLets Codex delegate coding and repository work to an installed Claude Code CLI with permission-aware inspect/write access, model and effort selection, resumable and cloud-attached sessions, and durable synchronous or asynchronous jobs.MIT
- AlicenseNot gradedqualityBmaintenanceEnables an external AI agent to delegate tasks to a local Claude Code installation and receive structured reports, with code modifications governed by a plan-approval-execution workflow and direct file and git operations available outside that loop.MIT
- AlicenseNot gradedqualityBmaintenanceEnables users to delegate coding tasks in a chosen project to the official Codex and Claude CLI agents from within an existing chat, then convene a council of configured models to gather independent opinions and review the resulting files and test runs. It also manages multi-provider API connections, model catalogs, and per-task token, time, and cost limits.MIT