cursor-sdk

What it is and what it does

cursor-sdk is a Python client for Cursor's agent platform, allowing you to script and automate the same AI agent that powers the Cursor IDE, CLI, and web app. It provides both synchronous and asynchronous interfaces to create and manage agents, with support for cloud-based agents that can run on empty VMs without a repository.

The SDK is in public beta and actively maintained, with wheels available for macOS, Linux, and Windows. It depends only on httpx for HTTP communication. Cloud agents can report billed token usage and dollar costs per run (server-derived and eventually consistent), though local agents are not yet supported. The package requires Python 3.10 or later and uses a shared versioning scheme with the JavaScript SDK starting from version 1.0.24.

Use it for:

• Automate code generation and refactoring tasks by scripting Cursor agents in CI/CD pipelines or batch processing workflows.
• Build no-repo cloud agents that run on ephemeral infrastructure without cloning a repository, for serverless or containerized agent execution.
• Track and monitor agent usage costs programmatically by querying per-run token consumption and billing data from cloud agents.
• Integrate Cursor's AI capabilities into custom Python applications via sync or async client APIs.
• Test and validate agent behavior across multiple environments by controlling agent creation and execution from Python scripts.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python SDK for scripting Cursor agents with sync and async clients, enabling programmatic control of the same agent that runs in the Cursor IDE, CLI, and web app.

Yes, with conditions. The SDK is actively maintained and has no known vulnerabilities, but it is in public beta—APIs may change before general availability. Install if you need programmatic control of Cursor agents or are building cloud-based automation. Verify Cursor's proprietary license terms for your use case before integrating into production or commercial projects.

Install

cursor-sdk on PyPI

pip install cursor-sdk

uv add cursor-sdk

poetry add cursor-sdk

Installing cursor-sdk

Before you install

Active maintenance with a release 1 day old. Medium install friction due to platform-specific wheels (macOS arm64/x64, Linux arm64/x64, Windows x64), but straightforward pip installation. Single runtime dependency on httpx.

License in practice

Licensed as Proprietary with unclear treatment. No standard SPDX identifier available. Users should review Cursor's licensing terms before integrating into commercial or redistributed projects.

Quickstart

pip install cursor-sdk

from cursor_sdk import Cursor

client = Cursor()
agent = client.agents.create(cloud=CloudAgentOptions(repos=[]))

Requires Python 3.10 or later. Cloud agents must be enabled for your account or team; repository-scoped API keys cannot create no-repo agents.

Verify before relying

• Whether the SDK's public-beta status implies breaking API changes are still expected before general availability.
• Cost calculation accuracy and eventual consistency guarantees for cloud agent usage billing.
• Support timeline and roadmap for local agents beyond current cloud-only implementation.

Package facts

Evidence: cursor_sdk-1.0.28-py3-none-macosx_11_0_arm64.whl; cursor_sdk-1.0.28-py3-none-macosx_11_0_x86_64.whl; cursor_sdk-1.0.28-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; cursor_sdk-1.0.28-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl; cursor_sdk-1.0.28-py3-none-win_amd64.whl

Tags

More Software Development packages