cursor-sdk

Python SDK for Cursor agents — script the same agent that runs in the Cursor IDE, CLI, and web app, with sync and async clients.

Docs and quickstart: https://cursor.com/docs/sdk/python

Shared SDK version

Starting with 1.0.24, the Python package and @cursor/sdk use the same version and are built from the same commit. Python therefore jumps directly from 0.1.9 to 1.0.24; there are no missing Python releases in between. The alignment does not change the Python SDK's public-beta status.

Install

pip install cursor-sdk

Requires Python 3.10+. Wheels are published for macOS (arm64, x64), Linux (arm64, x64), and Windows (x64).

No-repo cloud agents

Cloud agents can run on an empty VM with no repository. Pass cloud and leave repos unset:

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

No-repo agents must be enabled for your account or team, and repository-scoped API keys cannot create them. See examples/no_repo_cloud_agent.py.

For cloud agents, agent.get_usage() returns billed token usage and dollar cost per run. Cost is server-derived from Cursor's billing pipeline (discounts included, never estimated client-side) and eventually consistent shortly after a run ends. Local agents are not supported yet.

Public beta. APIs may change before general availability.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cursor_sdk-1.0.28.tar.gz (1.2 kB view details)

Uploaded Aug 13, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

cursor_sdk-1.0.28-py3-none-win_amd64.whl (45.8 MB view details)

Uploaded Aug 13, 2026 Python 3Windows x86-64

cursor_sdk-1.0.28-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (59.5 MB view details)

Uploaded Aug 13, 2026 Python 3manylinux: glibc 2.17+ x86-64

cursor_sdk-1.0.28-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl (58.8 MB view details)

Uploaded Aug 13, 2026 Python 3manylinux: glibc 2.17+ ARM64

cursor_sdk-1.0.28-py3-none-macosx_11_0_x86_64.whl (51.2 MB view details)

Uploaded Aug 13, 2026 Python 3macOS 11.0+ x86-64

cursor_sdk-1.0.28-py3-none-macosx_11_0_arm64.whl (49.7 MB view details)

Uploaded Aug 13, 2026 Python 3macOS 11.0+ ARM64

File details

Details for the file cursor_sdk-1.0.28.tar.gz.

File metadata

Download URL: cursor_sdk-1.0.28.tar.gz
Upload date: Aug 13, 2026
Size: 1.2 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for cursor_sdk-1.0.28.tar.gz
Algorithm	Hash digest
SHA256	`e7782527e0a62816abc0610df3abda893ff27b5ea7b8d470668e31d08892a604`
MD5	`a20d1ebb803e2197e56371bf9c0a9cc0`
BLAKE2b-256	`2d586b8ac6a13c6b2c621a02da646e773dff4225af48892b77294f1e3ca0e914`

See more details on using hashes here.

File details

Details for the file cursor_sdk-1.0.28-py3-none-win_amd64.whl.

File metadata

Download URL: cursor_sdk-1.0.28-py3-none-win_amd64.whl
Upload date: Aug 13, 2026
Size: 45.8 MB
Tags: Python 3, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for cursor_sdk-1.0.28-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`436a588f7d1433eae844d3959fd2bacbd73d6a0fee7859addc1b09e620f42ba6`
MD5	`69c80b442c4e456dc40cddacef712222`
BLAKE2b-256	`64c29af88511f7fe136b15d08cbece6c9191e16c9c988e66440dfdac6acc139c`

See more details on using hashes here.

File details

Details for the file cursor_sdk-1.0.28-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.

File metadata

Download URL: cursor_sdk-1.0.28-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Upload date: Aug 13, 2026
Size: 59.5 MB
Tags: Python 3, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for cursor_sdk-1.0.28-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm	Hash digest
SHA256	`a76f884ea91c21f75cb9391e65fe23bc626c4cb64b7fa32f63bac3d03f5df3da`
MD5	`9d4966672ea53097e38093088ab812a7`
BLAKE2b-256	`fd69a0f81e92a8b22637a0e2f9662eb7fdd2ed3902026a3856cba6dc1af1b337`

See more details on using hashes here.

File details

Details for the file cursor_sdk-1.0.28-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl.

File metadata

Download URL: cursor_sdk-1.0.28-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Upload date: Aug 13, 2026
Size: 58.8 MB
Tags: Python 3, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? No
Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for cursor_sdk-1.0.28-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Algorithm	Hash digest
SHA256	`602766b01f684c3bcbefaeb35d84c8f67ea36348e7320a8fa73fbd84f0ab567f`
MD5	`a8709715663f80eec0a53659c07fd531`
BLAKE2b-256	`71c0a5948407f9146b1104bc70649fe39b17d63f31ef0f3d6887348ca00a83ee`

See more details on using hashes here.

File details

Details for the file cursor_sdk-1.0.28-py3-none-macosx_11_0_x86_64.whl.

File metadata

Download URL: cursor_sdk-1.0.28-py3-none-macosx_11_0_x86_64.whl
Upload date: Aug 13, 2026
Size: 51.2 MB
Tags: Python 3, macOS 11.0+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for cursor_sdk-1.0.28-py3-none-macosx_11_0_x86_64.whl
Algorithm	Hash digest
SHA256	`2973f8b1642faea47e7bc98d4eefffcd0896bfc0d050203dd5a17b1cfe8d18c2`
MD5	`d6afa3628a96e6a21746e45a699afc70`
BLAKE2b-256	`c47d29f80425242322a159a75c955e963b4c774cda694b25bc54c03f8cdeec36`

See more details on using hashes here.

File details

Details for the file cursor_sdk-1.0.28-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: cursor_sdk-1.0.28-py3-none-macosx_11_0_arm64.whl
Upload date: Aug 13, 2026
Size: 49.7 MB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? No
Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for cursor_sdk-1.0.28-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`7a469b3e0c7492d8f5d51e60fc76e16374eabf25575e5f45eb47c43387ca422d`
MD5	`e592ae328aa608f17cbd452334a034aa`
BLAKE2b-256	`c8c76b3e67d2ad66031ed2eff69565926967d45f4b2e1baa053d4d27c1814208`