omnidapter 0.8.0

Provider-agnostic async integration library

Omnidapter Core

Provider-agnostic async calendar, booking, and CRM integration library for Python.

omnidapter gives you one API surface for calendars (Google, Microsoft, Zoho, Apple, generic CalDAV), booking (Cal.com, Square, Calendly, Zoho Bookings), and CRM (HubSpot, Pipedrive, Salesforce, Zoho CRM).

Installation

pip install omnidapter

Quick Start

Calendar

from omnidapter import Omnidapter

omni = Omnidapter(
    credential_store=my_store,
    oauth_state_store=my_state_store,
)

conn = await omni.connection("conn_123")
cal = conn.calendar()

calendars = await cal.list_calendars()

async for event in cal.list_events("primary"):
    print(event.summary)

Booking

from datetime import datetime, timezone
from omnidapter import Omnidapter, CreateBookingRequest, BookingCustomer

omni = Omnidapter(credential_store=my_store, oauth_state_store=my_state_store)

conn = await omni.connection("square_conn_1")
bk = conn.booking()

# Discover services and availability
services = await bk.list_services()
slots = await bk.get_availability(
    service_id=services[0].id,
    start=datetime(2026, 6, 1, tzinfo=timezone.utc),
    end=datetime(2026, 6, 7, tzinfo=timezone.utc),
)

# Book a slot
booking = await bk.create_booking(CreateBookingRequest(
    service_id=services[0].id,
    start=slots[0].start,
    customer=BookingCustomer(name="Jane Doe", email="[e-mail]"),
))
print(f"Booked: {booking.id} at {booking.start}")

# Cancel if needed
await bk.cancel_booking(booking.id)

Provider Keys

Calendar providers

• google
• microsoft
• zoho
• apple
• caldav (manual registration)

Booking providers

• calcom
• square
• calendly (read-only — no booking creation)
• zoho (Zoho Bookings)

CRM providers

• hubspot
• pipedrive
• salesforce
• zoho (Zoho CRM)

Documentation

Normative behaviour is committed as OpenSpec capability specs in the repository root under openspec/specs/:

• provider-registry, provider-metadata — provider setup, registration, custom providers
• service-calendar, service-booking, service-crm — service contracts and capabilities
• provider-<name> — per-provider behaviour, capability-flag values, and quirks
• auth-credential-storage — production credential and OAuth state storage patterns

See the repository README and ARCHITECTURE.md for the overview.

Notes

• In-memory stores are for development only.
• Persist encrypted credentials for production.
• OAuth state storage must be shared across instances.
• Use services=["booking"] when creating a connection to scope OAuth authorization to booking only. Omit to request all services the provider supports.

License

MIT