bitwarden-py 0.1.0

A simple Python wrapper for the Bitwarden CLI — programmatically read and update passwords stored in your Bitwarden vault.

bitwarden-py

A simple Python wrapper for the Bitwarden CLI — programmatically read and update passwords stored in your Bitwarden vault.

---

Requirements

Bitwarden CLI

bitwarden-py calls the official bw binary under the hood, so you must have it installed and available in your PATH.

Install it by following the official guide:
👉 https://bitwarden.com/help/cli/#download-and-install

Quick install options:

# macOS (Homebrew)
brew install bitwarden-cli

# Windows (Chocolatey)
choco install bitwarden-cli

# npm (cross-platform)
npm install -g @bitwarden/cli

After installation, verify it works:

bw --version

---

Installation

pip install bitwarden-py

Or with uv:

uv add bitwarden-py

---

Quick Start

from bitwarden_py import Bitwarden

bw = Bitwarden(
    email="[e-mail]",
    password="your_master_password",
)

# Fetch a password by item name
db_password = bw.get_password("My Database")
print(db_password)  # → "s3cr3t!"

# Update the password of an item
bw.set_password("My Database", "n3wp4ssw0rd")

Using a self-hosted server

By default the library points to https://vault.bitwarden.eu.
Pass server_url to connect to a different instance:

bw = Bitwarden(
    email="[e-mail]",
    password="your_master_password",
    server_url="https://bitwarden.yourcompany.com",
)

---

API Reference

Bitwarden(email, password, server_url?)

Creates a new client and authenticates with the vault.

Parameter	Type	Default	Description
email	str	—	Your Bitwarden account email
password	str	—	Your master password
server_url	str	"https://vault.bitwarden.eu"	Bitwarden server URL

bw.get_password(item_name) → str

Returns the password of the vault item matching item_name.

bw.set_password(item_name, new_password) → None

Updates the password of the vault item matching item_name.

---

License

MIT