keyhaven 0.0.1

Open-source Python SDK + CLI client for Keyhaven — OAuth and tool-calling for AI agents.

Keyhaven SDK

The open-source Python client for Keyhaven — OAuth & tool-calling for AI agents.

key + haven — a safe harbour for the keys your agents act through.

---

What is this?

Keyhaven is the OAuth + tool-calling layer for AI agents: your users connect their SaaS apps once, and your agents act on their behalf — through a per-tenant encrypted credential vault you never have to build.

This package is the client SDK (MIT). It talks over HTTP to a Keyhaven server. The server core is operated as a managed service (or self-hosted by the project owner); you only need this SDK and an API key.

Install

pip install keyhaven

Quickstart

from keyhaven import Keyhaven

async with Keyhaven(base_url="https://your-keyhaven-host", api_key="<your-api-key>") as kh:
    # 1. Start an OAuth connection for one of your users
    auth_url = await kh.connect("gmail", owner_id="user_123")
    #    → the user visits auth_url and consents; Keyhaven stores encrypted credentials

    # 2. Execute a tool on their behalf — anytime
    result = await kh.execute(
        "gmail.send_email",
        owner_id="user_123",
        args={"to": "[e-mail]", "subject": "Status", "body": "All good"},
    )

Sync variants (connect_sync, execute_sync, …) are available for non-async code.

Links

• Issues & docs: https://github.com/Joselma-Jemk/keyhaven-sdk

---

Client SDK — MIT. The Keyhaven server is a separate, proprietary component.