← Back to Cursor Usage

Install Cursor Usage

Pick your client, copy the command, done.

1

Add it to Claude Code

claude mcp add -e "CURSOR_API_KEY=${CURSOR_API_KEY}" cursor-usage -- npx -y cursor-usage-mcp
Required:CURSOR_API_KEY

Environment Variables

Set these before running Cursor Usage.

VariableDescriptionRequired
CURSOR_API_KEYYour Cursor Enterprise Admin API keyYes

Available Tools (7)

Once configured, Cursor Usage gives your AI agent access to:

get_team_membersList all team members with roles and status
get_spendingCurrent billing cycle spend per member
get_daily_usageDaily usage data: lines, requests, models, modes
get_billing_groupsBilling groups with member lists and spend
get_usage_eventsPer-request events with model, tokens, and costs
set_spend_limitSet a hard spending limit for a user
user_idlimit
get_dauGet daily active users

Try It Out

After setup, try these prompts with your AI agent:

How much did my team spend this week?
Who is using the most expensive models in our team?
Give me a full usage report for the current billing cycle.
List all team members and their current spending status.
Set a spending limit for the user with the highest usage.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • CURSOR_API_KEY — Your Cursor Enterprise Admin API key
Alternative installation methods

Claude Code

/plugin install cursor-usage

Manual

npx -y cursor-usage-mcp

Keep this setup from going cold

Save the docs, env vars, and workflow around Cursor Usage in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup