App Logo
cursor.com

Cursor — get usage

Automatically get usage on cursor.com. Read the signed-in Cursor account's usage for the current billing cycle: cycle start and end, plan name and price, membership type, percent of included usage used (total, Auto model, API/named models), included usage used / limit / remaining with its breakdown, on-demand (usage-based) spending, and team on-demand usage for team plans. Read-only; signed out is a clear error.

Input

None

Output

membershipType required
billingCycleEnd required
billingCycleStart required
included optional

The plan's included usage as Cursor reports it: used, limit, remaining and breakdown (included / bonus / total), in Cursor's own units.

onDemand optional

Usage-based (on-demand) spending: enabled, used, limit, remaining.

planName optional
planPrice optional
teamUsage optional
isUnlimited optional
percentUsed optional

FAQ

Read the signed-in Cursor account's usage for the current billing cycle: cycle start and end, plan name and price, membership type, percent of included usage used (total, Auto model, API/named models), included usage used / limit / remaining with its breakdown, on-demand (usage-based) spending, and team on-demand usage for team plans. Read-only; signed out is a clear error.
Ask an AI agent connected to Reduck to run reduck/cursor.com/get_usage, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/cursor.com/get_usage
You do not need one. "Cursor — get usage" drives the real cursor.com pages in a browser, so it works whether or not cursor.com offers an API for this.
Nothing. It takes no input.
It returns included, onDemand, planName, planPrice, teamUsage, isUnlimited, percentUsed, membershipType, billingCycleEnd, billingCycleStart.
Yes. It acts as you on cursor.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the cursor.com cookies saved by the Reduck extension.
It only reads. It looks things up on cursor.com and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/cursor.com/get_usage, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/cursor.com/get_usage
It is part of Reduck's official curated catalogue.

Related scripts

cursor.com

Cursor — list invoices

List Cursor billing invoices for the logged-in team. Returns each invoice's date, status, amount, a link to view it, and a direct PDF download link.

cursor.com

Cursor login (Google SSO)

Log into Cursor via "Continue with Google", driving the account chooser and landing on the Cursor dashboard. Requires running on the extension-paired browser rather than a managed/cloud browser.

cursor.com

Cursor whoami (signed-in account)

Report which Cursor account this browser is signed in as: the user id, email, name, plan (membership type) and team id. Being signed out, including an expired session, is reported as a normal answer (loggedIn false), not an error, so it can be used to check a session before running other Cursor scripts.

Start building not clicking

Get started for free