---
id: onepasswordconnectsdk
version: "2.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# onepasswordconnectsdk — Python SDK for 1Password Connect

License: permissive · Maintenance: active · Downloads: 177.0K/mo

## What it is and what it does

The 1Password Connect SDK is a Python client library for accessing 1Password vaults through a self-hosted Connect server. It abstracts the HTTP API behind a simple Python interface, letting you read secrets, create items, and manage vault contents programmatically without embedding credentials directly in your code. The library depends on httpx for HTTP communication and python-dateutil for timestamp handling.

You configure it via environment variables (OP_CONNECT_HOST, OP_CONNECT_TOKEN, and optionally OP_CONNECT_CLIENT_REQ_TIMEOUT) and then instantiate a client to perform vault operations. It's designed for applications that need to integrate 1Password as a centralized secrets store, such as deployment pipelines, configuration management tools, or services that need to fetch credentials at runtime.

Use it for:

- Retrieve database credentials or API keys from 1Password during application startup or on-demand.
- Automate secret rotation by reading updated credentials from 1Password in a CI/CD pipeline.
- Programmatically create and manage login items or secure notes in 1Password from Python applications.
- Build a secrets proxy that fetches credentials from 1Password and injects them into environment or configuration.
- Audit and sync secrets between 1Password and other systems by reading vault contents via the SDK.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python access to 1Password vaults through a self-hosted 1Password Connect server, allowing applications to read and write secrets programmatically.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and solves a clear problem for teams using 1Password as a centralized secrets store. It requires a self-hosted Connect server and proper environment setup, but those are architectural choices, not package defects. No known security vulnerabilities. Install it if you need programmatic access to 1Password vaults from Python.

## Install

pip install onepasswordconnectsdk
uv add onepasswordconnectsdk
poetry add onepasswordconnectsdk

## Installing onepasswordconnectsdk

Before you install: Low install friction with only two runtime dependencies (httpx and python-dateutil). Actively maintained as of August 2026 with recent commits; the repository is not archived and has modest community engagement (231 stars).

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install onepasswordconnectsdk

from onepasswordconnectsdk.client import new_client_from_environment

client = new_client_from_environment()
item = client.get_item(item_id, vault_id)

Requires OP_CONNECT_HOST and OP_CONNECT_TOKEN environment variables to be set, and a running 1Password Connect server accessible at the specified host.

Verify before relying:

- Whether the SDK supports all 1Password item types and field categories beyond the LOGIN example shown.
- Performance characteristics and rate limits when working with large vaults or frequent API calls.
- Whether custom timeout configuration via OP_CONNECT_CLIENT_REQ_TIMEOUT applies to all request types or only specific operations.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 177.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

1password sdk python, secrets management python, vault access api, credential retrieval python, 1password connect client, password storage integration, secret automation, secrets-management, 1password-integration

[View on SkillFed](https://skillfed.io/packages/onepasswordconnectsdk) · [View on PyPI](https://pypi.org/project/onepasswordconnectsdk/)