oomol-lab/open-connector
Open-source auth gateway connecting 1000+ SaaS providers to AI agents through SDK, CLI, MCP, HTTP, and OpenAPI.
4,353 ★339 forksTypeScriptUpdated 23h ago
What you need to know
An open-source (Apache 2.0) connector gateway for AI agents - an alternative to Pipedream/Composio - that connects user app accounts once and exposes a shared catalog of 1,000+ providers and 10,000+ prebuilt Actions to agents via MCP, HTTP/OpenAPI, SDK, and CLI.
Install
docker compose up (pulls ghcr.io/oomol-lab/open-connector:latest) npm install && npm run dev (local Node.js development, Node.js 22+) Deploy to Cloudflare Workers (D1/R2/Static Assets) via npm run deploy:cloudflare, or to Fly.io with SQLite storage
Usage
- •Open the local console at http://localhost:3000 and API reference at /docs
- •Connect a provider: curl -X PUT http://localhost:3000/api/connections/github with an API key, then run actions via POST /v1/actions/<provider>.<action>
- •Expose app Actions to MCP-capable agent hosts via http://localhost:3000/mcp
- •Use the Connector SDK (TypeScript HTTP client) from app code, or the oo CLI as a local agent relay
- •OAuth providers require OAuth client credentials you register - use OOMOL-hosted connectors to let users authorize without setting up OAuth apps
Key features
- ✓Connector catalog across GitHub, Gmail, Notion, BigQuery, Google Analytics, Supabase, Airtable, Slack, and more
- ✓Credential handling for API keys, OAuth2, custom credentials, and no-auth providers; provider secrets stay behind the runtime boundary
- ✓Inspectable Action contracts: request/response schemas, required scopes, lazy-loaded executor source
- ✓Runtime controls: connection identity, scopes, runtime tokens, allow/block policies, temp file transit, redacted run logs
- ✓Web Console dashboard for browsing providers, configuring credentials, creating tokens, and inspecting usage; deployment on local Docker, Fly.io, Cloudflare, or OOMOL hosted
Best for
Agent products that need durable, reusable access to a user's existing SaaS apps without handing provider credentials to the agent process.
Caveats
- ⚠Self-hosted runtimes need you to register your own OAuth apps with each provider; hosted OAuth requires the OOMOL service
- ⚠Requires Node.js 22+ for development/source builds
- ⚠Apache-2.0 license covers the repo's own code only; provider names/assets remain with their owners
Platforms: Cross-platform (Docker/Node.js) · Cloudflare Workers/D1/R2 · Fly.ioClients: MCP-capable agent hosts · oo CLI · Connector SDK · HTTP/OpenAPI clients
Documentation ↗Reviewed 2026-08-07
Topics
agent-toolsai-agentsapi-gatewayautomationclicloudflare-workersconnectorsintegration-platformmcpmodel-context-protocoloauthoomolopenapiopenconnectorsaas-integrationssdkself-hostedtypescript
- Stars
- 4,353★
- Forks
- 339
- Language
- TypeScript
- License
- Apache-2.0
- Created
- 2026-06-29
- Last push
- 2026-08-06