1Password Python SDK

Build integrations that programmatically interact with 1Password.

Requirements

The 1Password Python SDK is compatible with:

python 3.9 or later
libssl 3
glibc 2.32 or later

If you're running a Linux distribution that still uses libssl version 1.1.1, such as Debian 11 or Ubuntu 20.04, you'll need to update to a later version of Linux or install the required dependencies.

🚀 Get started

You can choose between two authentication methods for the 1Password Python SDK: local authorization prompts from the 1Password desktop app or automated authentication with a 1Password Service Account.

This project is licensed under MIT. Use of the 1Password APIs and services accessed through these tools is governed by the 1Password API Terms of Service.

Option 1: 1Password desktop app

1Password desktop app authentication is best for local integrations that require minimal setup from end users and sensitive workflows that require human-in-the-loop approval. To set up the SDK to authenticate with the 1Password app:

Install the 1Password desktop app and sign in to your account in the app.
Select your account or collection at the top of the sidebar, then navigate to Settings > Developer.
Under Integrate with the 1Password SDKs, select Integrate with other apps.
If you want to authenticate with biometrics, navigate to Settings > Security, then turn on the option to unlock using Touch ID, Windows Hello, or system authentication.
Install the 1Password Python SDK in your project:
```
pip install onepassword-sdk
```
To use the Python SDK in your project, replace your-account-name in the code below with the name of your 1Password account as it appears at the top left sidebar of the 1Password desktop app.

import asyncio
import os
from onepassword.client import Client, DesktopAuth

async def main():
    # Connects to 1Password. Fill in your own integration name and version.
    client = await Client.authenticate(
    auth=DesktopAuth(
        # TODO: Set to your 1Password account name.
        account_name="your-account-name"
    ),
    # TODO: Set to your own integration name and version.
    integration_name="My 1Password Integration",
    integration_version="v1.0.0",
)

    # Retrieves a secret from 1Password. Takes a secret reference as input and returns the secret to which it points.
    value = await client.secrets.resolve("op://vault/item/field")
    # use value here

if __name__ == '__main__':
    asyncio.run(main())

Make sure to use secret reference URIs with the syntax op://vault/item/field to securely load secrets from 1Password into your code.

Option 2: 1Password Service Account

Service account authentication is best for automated access and limiting your integration to least privilege access. To set up the SDK to authenticate with a service account token:

Create a service account and give it the appropriate permissions in the vaults where the items you want to use with the SDK are saved.
Provision your service account token. We recommend provisioning your token from the environment. For example, to export your token to the OP_SERVICE_ACCOUNT_TOKEN environment variable:

macOS or Linux
```
export OP_SERVICE_ACCOUNT_TOKEN=<your-service-account-token>
```
Windows
```
$Env:OP_SERVICE_ACCOUNT_TOKEN = "<your-service-account-token>"
```
Install the 1Password Python SDK in your project:
```
pip install onepassword-sdk
```
Use the Python SDK in your project:

import asyncio
import os
from onepassword.client import Client

async def main():
    # Gets your service account token from the OP_SERVICE_ACCOUNT_TOKEN environment variable.
    token = os.getenv("OP_SERVICE_ACCOUNT_TOKEN")

    # Connects to 1Password. Fill in your own integration name and version.
    client = await Client.authenticate(auth=token, integration_name="My 1Password Integration", integration_version="v1.0.0")

    # Retrieves a secret from 1Password. Takes a secret reference as input and returns the secret to which it points.
    value = await client.secrets.resolve("op://vault/item/field")
    # use value here

if __name__ == '__main__':
    asyncio.run(main())

Make sure to use secret reference URIs with the syntax op://vault/item/field to securely load secrets from 1Password into your code.

Supported functionality

1Password SDKs are in active development. We're keen to hear what you'd like to see next. Let us know by upvoting or filing an issue.

Item management

Operations:

Field types:

API Keys
Passwords
Concealed fields
Text fields
Notes
SSH private keys, public keys, fingerprint and key type
One-time passwords
URLs
Websites (used to suggest and autofill logins)
Phone numbers
Credit card types
Credit card numbers
Emails
References to other items
Address
Date
MM/YY
File attachments and Document items
Menu
Passkeys

Vault management

User & access management

Provision users
Retrieve users
List users
Suspend users
Retrieve groups
List groups
Create groups
Update group membership

Environments management

Read 1Password Environments (beta)

Compliance & reporting

Watchtower insights
Travel mode
Events. For now, use 1Password Events Reporting API directly.

Authentication

1Password Service Accounts
User authentication
1Password Connect. For now, use 1Password/connect-sdk-python.

📖 Learn more

Download files

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

Source Distribution

onepassword_sdk-0.4.1.tar.gz (34.6 MB view details)

Uploaded Jul 30, 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.

onepassword_sdk-0.4.1-cp313-cp313-win_amd64.whl (6.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.13Windows x86-64

onepassword_sdk-0.4.1-cp313-cp313-manylinux_2_32_x86_64.whl (7.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.13manylinux: glibc 2.32+ x86-64

onepassword_sdk-0.4.1-cp313-cp313-manylinux_2_32_aarch64.whl (7.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.13manylinux: glibc 2.32+ ARM64

onepassword_sdk-0.4.1-cp313-cp313-macosx_11_0_arm64.whl (7.0 MB view details)

Uploaded Jul 30, 2026 CPython 3.13macOS 11.0+ ARM64

onepassword_sdk-0.4.1-cp313-cp313-macosx_10_13_x86_64.whl (7.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.13macOS 10.13+ x86-64

onepassword_sdk-0.4.1-cp312-cp312-win_amd64.whl (6.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.12Windows x86-64

onepassword_sdk-0.4.1-cp312-cp312-manylinux_2_32_x86_64.whl (7.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.12manylinux: glibc 2.32+ x86-64

onepassword_sdk-0.4.1-cp312-cp312-manylinux_2_32_aarch64.whl (7.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.12manylinux: glibc 2.32+ ARM64

onepassword_sdk-0.4.1-cp312-cp312-macosx_11_0_arm64.whl (7.0 MB view details)

Uploaded Jul 30, 2026 CPython 3.12macOS 11.0+ ARM64

onepassword_sdk-0.4.1-cp312-cp312-macosx_10_9_x86_64.whl (7.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.12macOS 10.9+ x86-64

onepassword_sdk-0.4.1-cp311-cp311-win_amd64.whl (6.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.11Windows x86-64

onepassword_sdk-0.4.1-cp311-cp311-manylinux_2_32_x86_64.whl (7.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.11manylinux: glibc 2.32+ x86-64

onepassword_sdk-0.4.1-cp311-cp311-manylinux_2_32_aarch64.whl (7.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.11manylinux: glibc 2.32+ ARM64

onepassword_sdk-0.4.1-cp311-cp311-macosx_11_0_arm64.whl (7.0 MB view details)

Uploaded Jul 30, 2026 CPython 3.11macOS 11.0+ ARM64

onepassword_sdk-0.4.1-cp311-cp311-macosx_10_9_x86_64.whl (7.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.11macOS 10.9+ x86-64

onepassword_sdk-0.4.1-cp310-cp310-win_amd64.whl (6.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.10Windows x86-64

onepassword_sdk-0.4.1-cp310-cp310-manylinux_2_32_x86_64.whl (7.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.10manylinux: glibc 2.32+ x86-64

onepassword_sdk-0.4.1-cp310-cp310-manylinux_2_32_aarch64.whl (7.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.10manylinux: glibc 2.32+ ARM64

onepassword_sdk-0.4.1-cp310-cp310-macosx_11_0_arm64.whl (7.0 MB view details)

Uploaded Jul 30, 2026 CPython 3.10macOS 11.0+ ARM64

onepassword_sdk-0.4.1-cp310-cp310-macosx_10_9_x86_64.whl (7.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.10macOS 10.9+ x86-64

onepassword_sdk-0.4.1-cp39-cp39-win_amd64.whl (6.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.9Windows x86-64

onepassword_sdk-0.4.1-cp39-cp39-manylinux_2_32_x86_64.whl (7.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.9manylinux: glibc 2.32+ x86-64

onepassword_sdk-0.4.1-cp39-cp39-manylinux_2_32_aarch64.whl (7.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.9manylinux: glibc 2.32+ ARM64

onepassword_sdk-0.4.1-cp39-cp39-macosx_11_0_arm64.whl (7.0 MB view details)

Uploaded Jul 30, 2026 CPython 3.9macOS 11.0+ ARM64

onepassword_sdk-0.4.1-cp39-cp39-macosx_10_9_x86_64.whl (7.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.9macOS 10.9+ x86-64

File details

Details for the file onepassword_sdk-0.4.1.tar.gz.

File metadata

Download URL: onepassword_sdk-0.4.1.tar.gz
Upload date: Jul 30, 2026
Size: 34.6 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.5

File hashes

Hashes for onepassword_sdk-0.4.1.tar.gz
Algorithm	Hash digest
SHA256	`4b9224208aa6e35e13bad8534e6521d3abf5ba166ea4efd370fcdc918c4a4d26`
MD5	`f605909dd78a1a6951044e97f4d43d3e`
BLAKE2b-256	`df06989f5b40e802e11e37c44bc72faabcdd362dcba3392fbfc48be6da49e147`

Algorithm	Hash digest
SHA256	`45c2a2751017bd43697f949aea74efcd3058b2395dfa5d94c33adfb7ef96a60a`
MD5	`41df32a60e5d7d0b10e6ae150162e023`
BLAKE2b-256	`00e6c795eebd51be8cf70f61577d44eccb345df012d1bd036e7545dace0f944d`

Algorithm	Hash digest
SHA256	`438f3d11cc8ce74fb8fa06d6fe8ecb9c8f72ee1490a0ebd2e3f6029d61c3157c`
MD5	`9dbe525afdfd46db050a180d30889093`
BLAKE2b-256	`71be2b669a038881f98512587c512821a50d78b4eae8aa380253d35808643852`

Algorithm	Hash digest
SHA256	`55426aa708316698739babd87693d99312eeb3fbf45a429f467014b4c171d578`
MD5	`806eafec140cca56a450cd6ad3056ffc`
BLAKE2b-256	`3423d7e0adf4e619904e3be43084ba6bd607ce33dc46798f7c2a52c8d99af3a1`

Algorithm	Hash digest
SHA256	`e08741964f94b257ac843b01fbb260fa1ecea1da33e33132c27c33a001d1f750`
MD5	`cb01b5dd2db54e2a0553041289911b42`
BLAKE2b-256	`bc22aa06e570c0477a5ab05635f3f216158012bcb6a2a77a85da97d6e598fc0f`

Algorithm	Hash digest
SHA256	`3ab99159b0680781c29103e8a481487a7cbe307d80ca82d1ebe1696482717dbf`
MD5	`da3625a566e53a9302cad89d23efb67c`
BLAKE2b-256	`c31dfec27ec00105ada1baa0ed529925e213c87261da9e4bda8997ecb80f4361`

Algorithm	Hash digest
SHA256	`47492c131ae74280f2d98e8ba708bab7339001c30f57d96d65fadacdd6a152a0`
MD5	`d92efb1c0de201fd2a52f6c240113b42`
BLAKE2b-256	`e320420f0fb8075fb13a76dacc1215a177062374e195117af2843a8df7fc482a`

Algorithm	Hash digest
SHA256	`070541f5d007f8bfa63ffd937e4717e4d3d04100096e807a05028a8a62d49b94`
MD5	`c5700a060257af97614ffd0abf117137`
BLAKE2b-256	`227cca1529a3732605caad337b0f989c894ddfdf94995545393aa029d2fcc0b2`

Algorithm	Hash digest
SHA256	`59945589f2c816357322d3c8801efe66d8e6842dfba9740787979996b8467815`
MD5	`89e37512a4e39b7560ac5f93e1e44073`
BLAKE2b-256	`b0fa5d19c0f1dea47ed5fdc3b96760629b92b0785e75ab981993545806edcde6`

Algorithm	Hash digest
SHA256	`f4469602291a82a8b5ea019ed6cab142852ef3d09eceee94d21f6c67f8a478a9`
MD5	`27cdaf4eaf78ede6795809025e7219f8`
BLAKE2b-256	`df216c893de3c8cf51732ec240b87d6298cd1a130af2d5c917eb6a48076d3d63`

Algorithm	Hash digest
SHA256	`20ce4798e4f67e25564df947f1b45dac050b4c1b3c19305533346af5b5833d25`
MD5	`02fccda65874b6205e732eeda8356a1f`
BLAKE2b-256	`f06804e9006ecf2ef99e084042671d5fd28540a8199e7d8d4dac948581ebd152`

Algorithm	Hash digest
SHA256	`77b4e1c314adf931f9fe57a7cba0d01c4d26d40c19ca55545dfbcda5a9bcf791`
MD5	`59981040b19b316ed3db6694a4c8f316`
BLAKE2b-256	`45d257590b301061d1a7fcffc060997551e39b6d1eb20b2ba2ced2fc70341783`

Algorithm	Hash digest
SHA256	`5c09aa2fafe114efcf42ce3a5735f16b3cac27fed21835fb278e9dee9e675856`
MD5	`9d8eed36a02ffe5ade256666ddcc587a`
BLAKE2b-256	`b7c2fdec90a257a8c70165d3f853cda40c05f8eccf6f0b71509f6fb931d2ee32`

Algorithm	Hash digest
SHA256	`ece4f864235359490236947c78ece650b0a9140ec18d2eacbe16d478360be9ad`
MD5	`fb3e87f8b6c75562a1dab04f2029f8b0`
BLAKE2b-256	`ce8581e001e734018086fe6fac658b281af8ece29f05f9cd17e0e08b6924ca91`

Algorithm	Hash digest
SHA256	`17270148617e9bee15f15ae97697e4cd91749854a5b276121312f0dce3e604c3`
MD5	`4af8738881243c6c135880a3e3a647be`
BLAKE2b-256	`ddd7da8c25db5898afea7798bbadbe5175b5ef5d123db7d5e6382c82afb610f5`

Algorithm	Hash digest
SHA256	`498f47857676413f7e3da286dc7c55443244566a244d6a8646c9891c0881e48a`
MD5	`57da1bd83b94b9a42a2b0c845538c91a`
BLAKE2b-256	`3b6a5b2955dbd152f2cee0d5c87c8ad4e57fe080f4cb106ea5f4020d7cc0639a`

Algorithm	Hash digest
SHA256	`3937aa9f99ff02ccdd1a50d9ffb2723077c6122464f730b1e04fbd99d63be72f`
MD5	`175ea6ceb945fc8fa30364fb0c2c9db0`
BLAKE2b-256	`dea969a0d30fe0af57e10c107bd50d19718e24a8043a442b2593d7c33daa30f4`

Algorithm	Hash digest
SHA256	`adb3ce00cf0fa74041729d04fb279be3cd6e0800a1e7c61f0765ef35104b63ec`
MD5	`58f3b38e98ca6df73067855e391202d9`
BLAKE2b-256	`a1e0d61e32ee8205662a1e8a9281c38cf95a0d7a5b0c6261b9f331f178cadfa4`

Algorithm	Hash digest
SHA256	`ba80f83dd27291b69ff39a489af62910230ca51215002a2f2215c25720d2c9ad`
MD5	`ba4ad59bf2d44e3c2da66a8ace49f67b`
BLAKE2b-256	`bb4ae74731ab0d3ca111bb06d08eba49cae9ff91f0b882c60a2619e631cef776`

Algorithm	Hash digest
SHA256	`1d7749fd8dd36189b7021d8a7e94ce587c4e75e1a7e4faf7db613557e88f48a9`
MD5	`da71ecf4b51c506f4c6b6355bd5d61cc`
BLAKE2b-256	`d5d7977e91552d3a1fd2ae2f9aeb69a35f6809e77ad3dd52cda279825dd1624b`

Algorithm	Hash digest
SHA256	`b4101a3996197a65b1d7826bffd821feb16d159253c16bd89d6dde8105103c61`
MD5	`e3a757e594f2b61c1218979ef2d033b3`
BLAKE2b-256	`e1e4767d11ad6244e934712fba16031356b2be26766dc5b711fa7422bff29555`

onepassword-sdk 0.4.1

1Password Python SDK

Build integrations that programmatically interact with 1Password.

Requirements

🚀 Get started

Option 1: 1Password desktop app

Option 2: 1Password Service Account

Supported functionality

Item management

Vault management

User & access management

Environments management

Compliance & reporting

Authentication

📖 Learn more

Project links

Key dates

1 maintainer

Credits

License

Requires

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

Algorithm	Hash digest
SHA256	`6b1c822df08f0539ecdf20013dd1ce30e98f99dd504e8cee73a0fb650e497f35`
MD5	`85ff89d91966ae1f974845b97c22b97f`
BLAKE2b-256	`1b057354f28ac4a326caa70f8d9e8d43d92a626f10936d776f610064d554a96b`

Algorithm	Hash digest
SHA256	`8db120e41c51eb956cad55ddd9ca08fa4769c937b546d3bad178fba28370ad01`
MD5	`d1cbfc5a408c16d018ae92f2a598447e`
BLAKE2b-256	`5e857eb7aa673d3357f36e53f49d1fa16b8795a801c1f0ead97c83e051c6fc7a`

Algorithm	Hash digest
SHA256	`f789980c2fa8f0840dc16813aed37cb23e8ae8c4468aaff222c4b7e083b3a81e`
MD5	`e8b26d20c805a4dcd87dcf376121d156`
BLAKE2b-256	`a9413519571ffd9e2c9946473102874a63e9d0a98f7971497efa1d701d5599f0`

Algorithm	Hash digest
SHA256	`7ee34f276017248eb34cfbd2f1ae7aef25b29fdcd69b8b4c67cbc10b85ca475f`
MD5	`b4eb4f67ddf455d1a0d6b13a67f4169a`
BLAKE2b-256	`d0fa9a3dc90d14db692337e017bd7868e7b3e544570e593b5449b3cccbddfa96`

Algorithm	Hash digest
SHA256	`d67fb2e48806e07431ad42dc7bce227d8833c487f71dfb800bf1cc8013a636a0`
MD5	`4973c89fdcd9d1a577cfb2ce769be962`
BLAKE2b-256	`d420e0509e74c67c4def70f5c1511c2e2eaf6c7c3b3dabd6dedd54f04e1ac9b3`