Skip to main content

Connect Cursor to LinearB

Connect Cursor to LinearB with an Admin API key to measure adoption, accepted code, model usage, tokens, and estimated consumption.

Steven Silverstone
Updated by Steven Silverstone

Overview

Connect Cursor to LinearB to collect Cursor usage and adoption data across your organization.

Cursor is connected using a Cursor Admin API key with the admin:read scope. In LinearB, this is shown as the Access token connection type.

Connection type: Cursor currently supports one connection type in LinearB: Access token.

Data Provided by Cursor

Depending on the data returned by Cursor, the connection can provide:

  • Active and engaged users
  • AI-assisted requests
  • Code suggestions and acceptances
  • Accepted lines of code
  • Model usage
  • Token usage
  • Estimated consumption

Adoption and accepted-lines data appears in AI Analytics.

Model, token, and estimated-consumption data is available through Metrics Builder. Predefined consumption queries can be grouped by supported dimensions such as model, team, repository, or day.

Note: Estimated consumption is not a billing total. Vendor plans, discounts, credits, negotiated pricing, and pricing changes can cause the estimate to differ from the provider’s invoice.

Historical Data and Collection Cadence

  • LinearB can backfill up to 30 days of historical Cursor usage during the initial connection.
  • Activity outside the available initial backfill window does not appear in LinearB.
  • After the initial connection, Cursor usage data is updated daily.

Before You Begin

Verify that you have:

  • Access to AI Tools settings in LinearB.
  • An admin or unpaid-admin role in Cursor.
  • Permission to create a Cursor Admin API key.
Required key: Generate a Cursor Admin API key with the admin:read scope. User API keys and Agent API keys do not provide the usage data required by LinearB.
Security: Treat the API key like a password and store it securely. Copy it immediately after creation because Cursor may not display it again.

Create a Cursor Admin API Key

  1. Sign in to Cursor with an admin or unpaid-admin account.
  2. Open Account Settings.
  3. Go to Settings → Advanced → API Keys.
  4. Click Create New API Key.
  5. Enter a descriptive name, such as LinearB Usage Integration.
  6. Select the admin:read scope.
  7. Create the key.
  8. Copy and securely store the generated key.
Important: Do not use a User API key or Agent API key. These key types cause authentication or data-access errors when used with LinearB.

Connect Cursor in LinearB

  1. Go to Settings → Company Settings → AI Tools → Integrations.
  2. Click Add New.
  3. Select Cursor.
  4. Click Continue.
  5. Select Access token.
  6. Click Continue.
  7. Paste the Cursor Admin API key into the Token field.
  8. Click Connect.

LinearB validates the token and its permissions. When validation succeeds, Cursor — Access token appears in the Connected list.


Verify the Connection

  1. Open Settings → Company Settings → AI Tools → Integrations.
  2. Select Connected.
  3. Select Cursor — Access token.
  4. Confirm that the integration status is Connected.
  5. Allow time for the initial historical import and daily processing.
  6. Open AI Analytics and confirm that Cursor adoption and acceptance data appears.

Edit the Cursor Connection

Use Edit mode to replace the Cursor Admin API key without disconnecting the integration.

  1. Go to Settings → Company Settings → AI Tools → Integrations.
  2. Select Connected.
  3. Select Cursor — Access token.
  4. Under Main Settings, click Edit.
  5. Update the Cursor Admin API key in the Token field.
  6. Click Save changes

How did we do?

Connect Claude Code using the Analytics API

Connect GitHub Copilot Enterprise

Contact