Package Information
DocumentationAI-generated
n8n-nodes-cursor
Overview
Integrate Cursor's REST API to spawn and manage AI coding agents within n8n workflows. This package targets developers and automation specialists who want to automate interactions with Cursor coding agents for GitHub repositories. It provides operations to create, control, and query AI coding agents, runs, and models, as well as triggering workflows based on run completions.
Nodes & Operations
Cursor
Manage AI coding agents for GitHub repositories by creating, querying, messaging, and controlling their lifecycle, including handling runs and available models.
- Agent · Archive — Archive an agent identified by its Agent ID, marking it as archived in the Cursor system.
- Agent · Create — Create a new persistent AI agent configured for a specified GitHub repository and model, with optional automatic pull request creation and custom agent naming.
- Agent · Delete — Delete an agent by its unique Agent ID, permanently removing it from the Cursor service.
- Agent · Get — Retrieve detailed metadata for a specific Cursor AI coding agent by its unique Agent ID.
- Agent · List — Retrieve a list of AI coding agents, up to a specified maximum number of results.
- Agent · Prompt — Send a one-shot prompt message to a newly created AI agent tied to a GitHub repository and receive its processed response after completion.
- Agent · Resume — Send a prompt message to an existing agent to resume its operation and wait for the run to complete, returning the final status and result.
- Agent · Send Message — Send a message prompt to an existing agent identified by its Agent ID, and receive the agent's run status and result after processing the message.
- Run · Cancel — Cancel a specific run associated with a given agent by its IDs in the Cursor platform.
- Run · Get — Retrieve details of a specific run identified by its Run ID and the Agent ID that owns it.
- Run · List — List runs for a specified agent, returning up to a user-defined maximum number of results.
- Model · List — List all available Cursor models by retrieving the complete set from the Cursor API.
- Account · Get Current User — Retrieve details about the current user associated with the Cursor API key used in the credentials.
Cursor Trigger
Poll Cursor cloud agent runs and trigger workflows automatically when agent runs complete, error, or are cancelled, enabling event-driven automation based on agent activity.
- Default · Default — Poll for the completion status of a Cursor cloud agent run and trigger the workflow when the run is finished, errored, or cancelled.
Credentials
Authenticate using a Cursor API key configured in the node credentials to authorize requests and access user-specific resources via the Cursor REST API.
Installation
Install as an n8n community node: in n8n, open Settings → Community nodes → Install and enter n8n-nodes-cursor.