> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/ai/cursor.md).

# Cursor

Cursor is an AI-powered code editor built for developer productivity. Connecting Cursor to Harmony via the Team Admin API gives IT teams visibility into seat utilization, usage activity, and AI request volume across the organization - making it easy to manage licenses and measure adoption.

#### What the Cursor integration enables

| Capability             | Description                                                                                     |
| ---------------------- | ----------------------------------------------------------------------------------------------- |
| User Discovery         | Surface all Cursor team members in Harmony's software inventory, derived from daily usage data  |
| Usage Tracking         | Monitor per-user activity, request volume, and AI model usage to understand seat utilization    |
| AI Request Metrics     | Track agent requests, usage-based requests, and subscription-included requests per user per day |
| Multi-Instance Support | Connect multiple Cursor workspaces for organizations with separate teams                        |

#### Prerequisites

* **Cursor Team Admin**: Admin access to the Cursor team workspace
* **Team API Key**: A key starting with `crsr_` (see below)
* **Harmony Account**: Active Harmony workspace

#### Connect Cursor to Harmony

**Step 1: Generate a Team API Key**

1. Log in to Cursor and go to **Settings** > **Team**
2. Navigate to the **API Keys** section
3. Click **Generate new key**, enter a name (e.g. `Harmony Integration`), and confirm
4. Copy the key - it starts with `crsr_`

**Step 2: Navigate to Integrations**

1. Log in to your Harmony dashboard
2. Go to **Settings** > **Integrations**
3. Find **Cursor** under **AI** and click **Connect**

**Step 3: Enter Credentials**

1. Paste your **API Key**
2. Click **Connect**

{% hint style="info" %}
For organizations with multiple Cursor workspaces, you can add multiple instances by repeating this process for each workspace.
{% endhint %}

#### What Harmony Syncs

**From Cursor:**

* Team members (name, email, role) - derived from usage data and deduplicated to reflect the most recent activity
* Per-user usage and activity data, including the most-used AI model
* Daily request volume broken down by type:
  * **Agent requests** - requests made through Cursor's agent mode
  * **Usage-based requests** - requests billed outside the subscription allowance
  * **Subscription-included requests** - requests covered under the base plan
* Seat allocation and license status

{% hint style="info" %}
Harmony pulls Cursor usage data on a daily basis and keeps the user roster current based on the latest activity.
{% endhint %}

#### Use Cases

<details>

<summary>License Optimization</summary>

Identify developers who haven't used Cursor recently and reclaim seats to reduce subscription costs

</details>

<details>

<summary>AI Tool Adoption</summary>

Track Cursor adoption across engineering teams to measure the impact of AI-assisted development. Use per-user request volume and model preferences to understand how deeply the tool is being used.

</details>

<details>

<summary>AI Spend Visibility</summary>

Monitor usage-based requests separately from subscription-included requests to anticipate overage costs and right-size your Cursor plan.

</details>

<details>

<summary>Offboarding</summary>

Confirm Cursor access has been removed when developers leave, as part of Harmony offboarding workflows

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.harmony.io/integrations/ai/cursor.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.