Cursor Node
The Cursor node provides integration with the Cursor AI code editor platform in SkyStudio workflows. You can list team members, query spending and usage data, retrieve analytics reports, and query the Cursor AI assistant using natural language. The connection uses a Cursor API Key.
Connection Setup and Management
To use the Cursor node, you must get an API Key from your Cursor account and add it to SkyStudio.
🎬 Click to watch the video →
Getting a Cursor API Key
- Open the Cursor application.
- Click Dashboard from the top menu.
- Go to the API Key section at the bottom of the Dashboard.
- Click the New API Key button.
- Give the API Key a name and click Save.
- Copy the generated API Key, which is in the
key_xxx...format.
Note: The API Key is displayed only at the time it is created. If you forget to save it, you must create a new key.
Adding the Connection to SkyStudio
- Go to Application Connections from the top menu in SkyStudio.
- Click the New Connection button.
- Select Cursor as the provider.
- Fill in the following fields:
| Field | Description |
|---|---|
| Connection Name | A descriptive name, such as Company Cursor |
| API Key | The API Key you obtained from the Cursor Dashboard, in the key_xxx... format |
- Click the Save button.
Assigning the Connection to the Node
After adding the Cursor node to the canvas, select the saved connection from the Application Connections dropdown in the right panel.
Operations
The Cursor node provides 7 operations:
| Operation | Category | Description |
|---|---|---|
| Get Team Members | Featured | Lists all users in the Cursor team |
| Spending Data | Featured | Retrieves user-based spending data with pagination support |
| Daily Usage | Featured | Returns daily usage statistics for a specific date range |
| Analytics Team | Featured | Retrieves team-wide analytics metrics with date and user filters |
| Cursor AI Assistant | Featured | Queries Cursor data using natural language |
| Usage Events Detail | Standard | Lists detailed user-based usage events |
| Analytics User-Based | Standard | Retrieves individual user analytics metrics with date filters |
Get Team Members
Lists all team members in your Cursor account, including name, email, and role information.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Cursor connection to use |
Example Output
{
"members": [
{
"id": "user_abc123",
"email": "ahmet@company.com",
"name": "Ahmet Yılmaz",
"role": "member"
},
{
"id": "user_def456",
"email": "ayse@company.com",
"name": "Ayşe Kaya",
"role": "admin"
}
]
}
Spending Data
Lists spending data by user. You can filter by a specific user and apply sorting and pagination.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Cursor connection to use |
| User Filter | No | User information to filter by, such as user email |
| Sort | No | Sorting direction for the results |
| Page Number | No | Page number for pagination. Default: 1 |
| Page Size | No | Number of records to return on each page |
Example Output
{
"data": [
{
"user_email": "ahmet@company.com",
"total_cost": 12.50,
"currency": "USD",
"period": "2024-06"
}
],
"total": 15,
"page": 1
}
Daily Usage
Returns daily Cursor usage statistics for the specified date range. It is used to track how much usage occurred on specific days.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Cursor connection to use |
| Start Date | No | Start date, such as 2024-06-01 |
| End Date | No | End date, such as 2024-06-30 |
| Page Number | No | Page number for pagination |
| Page Size | No | Number of records to return on each page |
Example Output
{
"usage": [
{
"date": "2024-06-15",
"total_requests": 342,
"total_tokens": 128500,
"active_users": 8
}
]
}
Analytics Team
Retrieves team-wide analytics data for a specific metric using date range and user filters.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Cursor connection to use |
| Metric | No | Analytics metric to query, such as requests or tokens |
| Start Date | No | Start date, such as 2024-06-01 |
| End Date | No | End date, such as 2024-06-30 |
| User Filter CSV | No | Comma-separated list of user emails, such as ahmet@company.com,ayse@company.com |
| Page Number | No | Page number for pagination |
| Page Size | No | Number of records to return on each page |
Cursor AI Assistant
Queries Cursor data using natural language. As shown in the video, you can write free-text queries such as “show the 5 people who used Cursor the most this month”.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Cursor connection to use |
| Query | Yes | Cursor query in natural language |
| System Prompt | No | System instruction that customizes the AI assistant’s behavior |
Usage Example
Query: "Show the 5 people who used Cursor the most this month"
System Prompt: "Use only this month’s data. Return the results in Turkish and sort them by usage amount."
Usage Events Detail
Lists detailed Cursor usage events by user. It is used to inspect the activities of a specific user.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Cursor connection to use |
| User Email optional | No | Email address of the user whose events will be filtered |
| Page Number | No | Page number for pagination |
| Page Size | No | Number of records to return on each page |
Analytics User-Based
Retrieves analytics metric data for individual users using date range and user filters. It is used for individual performance and usage comparisons within the team.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Cursor connection to use |
| Metric | No | Analytics metric to query |
| Start Date | No | Start date, such as 2024-06-01 |
| End Date | No | End date, such as 2024-06-30 |
| User Filter CSV | No | Comma-separated list of user emails |
| Page Number | No | Page number for pagination |
| Page Size | No | Number of records to return on each page |
Quick Start Examples
Example 1: Weekly Cursor Usage Report
A workflow that summarizes the team’s weekly Cursor usage and sends it to Slack:
Schedule (Every Monday) → Daily Usage → LLM (summarize) → Send Channel Message (Slack)
Daily Usage settings:
- Start Date:
{{last_week_start}} - End Date:
{{last_week_end}}
Example 2: Most Active Cursor Users
A workflow that lists the most active developers using the Cursor AI Assistant:
Schedule (Monthly) → Cursor AI Assistant → Text Output
Cursor AI Assistant settings:
- Query:
"List the 10 users who sent the most requests this month" - System Prompt:
"Return the results in table format and in Turkish."
Example 3: Cost Tracking Dashboard
A workflow that retrieves monthly spending data and reports it to management:
Schedule (1st day of the month) → Spending Data → LLM (format report) → Send Mail (Outlook)
Spending Data settings:
- Page Size:
50 - Sort: Descending by spending
Example 4: Personal Usage Chatbot
A chatbot that allows employees to query their own Cursor usage:
Text Input → Cursor AI Assistant → Text Output
Cursor AI Assistant settings:
- Query:
{{input.text}} - System Prompt:
"You are a Cursor usage assistant. Explain the user’s own statistics in Turkish."
Common Errors
| Error | Possible Cause | Solution |
|---|---|---|
401 Unauthorized | API Key is invalid or expired | Create a new key from Cursor Dashboard → API Key section and update the SkyStudio connection |
403 Forbidden | API Key permissions are insufficient | Make sure you have admin permissions in the Cursor account |
| Empty data returned | No records exist in the selected date range | Expand the Start Date / End Date range |
404 Not Found | User filter is incorrect | Check that the email address is registered in the Cursor team |
| AI Assistant does not respond | Query field is empty | Enter a valid text query in the Query field |
Notes
- The Cursor API Key is in the
key_xxx...format. It is displayed only once when created from the Dashboard, so store it securely. - In the Analytics Team and Analytics User-Based operations, the User Filter field accepts multiple comma-separated email addresses, such as
a@company.com,b@company.com. - The Cursor AI Assistant operation works similarly to the Fireflies AI Assistant; it interprets team usage data through natural language queries.
- If Start Date / End Date are not specified in the Daily Usage and Spending Data operations, the API may return all historical data. Use pagination parameters for large teams.
- When you need to renew the API Key, remember to update the connection in SkyStudio as well.