openconn 0.1.0

Pre-built action connectors for 3rd-party services — bring your own credentials

openconn

Pre-built action connectors for 3rd-party services. Bring your own credentials.

Why openconn?

• No cloud, no lock-in — runs entirely in your own process with credentials you supply
• Action-oriented — discrete, named actions (send_message, upload_file) rather than data sync primitives
• Framework-agnostic — plain async Python, no coupling to LangChain, pydantic-ai, or any agent framework
• Installable per-connector — only pull in the SDKs you actually use

Install

uv add openconn[slack]
uv add openconn[google-drive]
uv add openconn[slack,google-drive]
uv add openconn[all]

Quick start

import asyncio
from openconn import ConnectorRegistry

async def main():
    # Instantiate a connector
    slack = ConnectorRegistry.create("slack")

    # Connect with your credentials
    await slack.connect({"bot_token": "xoxb-your-token-here"})

    # Execute an action
    result = await slack.execute_action("send_message", {
        "channel": "C12345678",
        "text": "Hello from openconn!",
    })

    # Use the result
    print(result.text)           # "Message sent to channel C12345678."
    print(result.data["ts"])     # "1234567890.123456"

asyncio.run(main())

Connector support

Connector	Extra	Status
Slack	[slack]	Done
Google Drive	[google-drive]	Done
GitHub	[github]	Soon
Gmail	[gmail]	Soon
Google Sheets	[google-sheets]	Soon
Notion	[notion]	Soon
Jira	[jira]	Soon
Linear	[linear]	Soon
Airtable	[airtable]	Soon
Discord	[discord]	Soon

Credential schemas

Slack

{
    "bot_token": "xoxb-..."   # OAuth & Permissions page in your Slack App dashboard
}

Google Drive

{
    "token":          "ya29.a...",
    "refresh_token":  "1//...",
    "client_id":      "....apps.googleusercontent.com",
    "client_secret":  "...",
    "token_uri":      "https://oauth2.googleapis.com/token",   # optional
}

Docs

• Connector reference — credential schemas and full action tables
• Adding a connector — step-by-step guide for contributors

License

MIT