Skip to main content

A Python client and wrapper around the 1Password CLI.

Project description

OnePassword python client

Build Status

Python wrapper around 1Password password manager for usage within python scripts and Jupyter Notebooks. Developed by Data Scientists from Wandera to be used within both research and python services use cases.


pip install 1password

If you have issues with PyYaml or other distutils installed packages then use:

pip install --ignore-installed 1password

Both of these will install the op cli and python client. This is currently fixed at op version 1.8.0 to ensure compatibility. If you wish to use a higher version of op you can by running op update in a terminal however note that we cannot ensure it will work with our client yet.

Mac OS users will be prompted with a seperate installation windows to ensure you have a signed version of op - make sure to check other desktops that the installer might pop up on.

Basic Usage

Currently tested on Mac OS and Linux.

On first usage users will be asked for both the enrolled email, secret key and master password. There is also verification of your account domain and name.

For all following usages you will only be asked for a master password.

You will be given 3 attempts and then pointed to reset password documentation or alternatively you can restart your kernel.

No passwords are stored in memory without encryption.

from onepassword import OnePassword
import json

op = OnePassword()

# List all vaults 

# List all items in a vault, default is Private

# Get all fields, one field or more fields for an item with uuid="example"
op.get_item(uuid="example", fields="username")
op.get_item(uuid="example", fields=["username", "password"])

Input formats

To be sure what you are using is of the right format

  • Enrolled email: standard email format e.g.
  • Secret key: provided by 1Password e.g. ##-######-######-#####-#####-#####-#####
  • Account domain: domain that you would login to 1Password via browser e.g.
  • Account name: subdomain or account name that cli can use for multiple account holders e.g. example


The travis build will run with any PR or commit to master branch and then updates the master branch with a new minor version for contributors to branch from.

This means when contributing you should create a feature branch off of the master branch and without manually bumping the version can focus on development. Merge back into master.

Later admins will bump major versions.

CLI coverage

Full op documentation can be found here:

The below is correct as of version 0.3.0.


This is the set of commands the current python SDK covers:

  • create: Create an object
    • document
  • delete: Remove an object
    • item: we use this method to remove documents but now there is a new delete document method
  • get: Get details about an object
    • document
    • item
  • list: List objects and events
    • items
    • vaults
  • signin: Sign in to a 1Password account
  • signout: Sign out of a 1Password account

This is what still needs developing due to new functionality being released:

  • add: Grant access to groups or vaults
    • group
    • user
  • completion: Generate shell completion information
  • confirm: Confirm a user
  • create: Create an object
    • group
    • user
    • item
    • vault
  • delete: Remove an object
    • document
    • user
    • vault
    • group
    • trash
  • edit: Edit an object
    • document
    • group
    • item
    • user
    • vault
  • encode: Encode the JSON needed to create an item
  • forget: Remove a 1Password account from this device
  • get: Get details about an object
    • account
    • group
    • template
    • totp
    • user
    • vault
  • list: List objects and events
    • documents
    • events
    • groups
    • templates
    • users
  • reactivate: Reactivate a suspended user
  • remove: Revoke access to groups or vaults
  • suspend: Suspend a user
  • update: Check for and download updates


  • Add test docker image
  • Align response types into JSON / lists instead of JSON strings
  • Ensure full and matching functionality of CLI in python
    • add
    • confirm
    • create
    • delete
    • edit
    • encode
    • forget
    • get
    • list
    • reactivate
    • remove
    • suspend
  • Use the new CLI update method

Project details

Download files

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

Source Distribution

1password-0.4.3.tar.gz (11.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page