cursor-sdk
Python client for the Cursor SDK bridge.
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- 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.
- Active maintenance with a release 1 day old.
License · maintenance · safety
Proprietary (unclear) — 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.
last release 2026-08-13 (1 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 383,602 downloads/mo, #7,075 on PyPI
Alternatives
Verify before relying
pip install cursor-sdk
from cursor_sdk import Cursor
client = Cursor()
agent = client.agents.create(cloud=CloudAgentOptions(repos=[]))- 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.
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 on it.
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
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.
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.
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=[]))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
| License | Proprietary unclear |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 1 packagehttpx |
| Maintenance | Actively maintained 1 days since the last release |
| First released | |
| Downloads | 383,602 / month, #7,075 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: Other/Proprietary LicenseOperating System :: MacOSOperating System :: Microsoft :: WindowsOperating System :: POSIX :: LinuxProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Topic :: Software DevelopmentTyping :: Typed |
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
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “cursor agent sdk python”
- cursor-sdkPython SDK for scripting Cursor agents with sync and async clients,…
- composioComposio provides a Python SDK that connects AI agents to 1000+…
- detect_agentDetects whether code is running in an AI agent or automated…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also hud-sdk · plato-sdk · clawmetry · deepagents-code · openhands-sdk · openhands-workspace · openhands-tools · openhands-ai · detect_agent · pairmux