{"repo":"oomol-lab/open-connector","free":true,"listed":false,"github":"https://github.com/oomol-lab/open-connector","clone":"git clone https://github.com/oomol-lab/open-connector.git","description":"Open-source auth gateway connecting 1000+ SaaS providers to AI agents through SDK, CLI, MCP, HTTP, and OpenAPI.","language":"TypeScript","stars":4725,"topics":["agent-tools","ai-agents","api-gateway","automation","cli","cloudflare-workers","connectors","integration-platform","mcp","model-context-protocol","oauth","oomol","openapi","openconnector","saas-integrations","sdk","self-hosted","typescript"],"license":"Apache-2.0","category":"integration_platform","readme_excerpt":"
\n\n\"OpenConnector\n\n[English](README.md) | [简体中文](docs/README.zh-CN.md) | [繁體中文](docs/README.zh-TW.md) | [日本語](docs/README.ja.md) | [한국어](docs/README.ko.md) | [Русский](docs/README.ru.md) | [Français](docs/README.fr.md)\n\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE.txt)\n![Node.js 22+](https://img.shields.io/badge/Node.js-22%2B-339933)\n![Cloudflare compatible](https://img.shields.io/badge/Cloudflare-compatible-F38020)\n![MCP](https://img.shields.io/badge/MCP-ready-111827)\n![OpenAPI](https://img.shields.io/badge/OpenAPI-3.1-6BA539)\n\n[![Providers](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fconnector.oomol.com%2Fv1%2Fcatalog&query=data.providerCount&label=Providers&color=%237d7fe9)](https://oomol.com/apps)\n[![Actions](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fconnector.oomol.com%2Fv1%2Fcatalog&query=data.actionCount&label=Actions&color=%237d7fe9)](https://oomol.com/apps)\n\n
\n\nOpenConnector is an open-source connector gateway for AI agents and an alternative to Pipedream/Composio.\nConnect user app accounts once, then expose a shared catalog of 1,000+ providers and 10,000+\nprebuilt Actions to agents and applications.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
\"OOMOL\"\"Cloudflare\"\"Self-hosted\"
Managed OAuth and hosted runtime, ready to use. No deployment or OAuth app setup.Run on Workers, D1, R2, and Static Assets in your Cloudflare account. You manage deployment and OAuth apps.Run locally or on your own infrastructure with Docker or Node.js. You manage storage and OAuth apps.
🚀 OOMOL HostedDeploy to CloudflareSelf-host
\n\nUse the [Connector SDK](https://github.com/oomol-lab/connector-sdk) from app code,\n[oo CLI](https://github.com/oomol-lab/oo-cli) as the local-agent relay, MCP from agent hosts,\nHTTP/OpenAPI from custom clients, and the Web Console for administration and debugging.\n\n- Keep credentials, scopes, schemas, policies, and run logs inside an inspectable runtime.\n- Run locally, on Fly.io, on Cloudflare-compatible infrastructure, or through OOMOL's hosted\n runtime.\n- Use the same provider ids, Action ids, schemas, and contracts across open-source and commercial\n SaaS deployments.\n\n## What It Provides\n\n- A working connector catalog across products such as GitHub, Gmail, Notion, BigQuery, Google\n Analytics, Supabase, Airtable, Slack, and more.\n- Credential handling for API keys, OAuth2, custom credentials, and no-auth providers.\n- Inspectable Action contracts: request/response schemas, required scopes, and lazy-loaded executor\n source.\n- Runtime controls for connection identity, scopes, runtime tokens, action allow/block policies,\n temporary file transit, and redacted run logs.\n- Deployment options for local Docker or Node.js, Fly.io with persistent SQLite storage,\n Cloudflare Workers with D1/R2/Static Assets, and OOMOL's hosted runtime.\n\n## Where It Fits\n\nOpenConnector fits products where agents need durable access to the tools users already use, without\nhanding provider credentials to the agent process.\n\n- Agent products that need reusable access across work apps, developer tools, data systems,\n communication platforms, and AI services.\n- Products adding agent workflows that need stable, inspectable Action contracts for user app\n access.\n- Teams that want hosted auth for speed while keeping a path to private or self-hosted runtime\n control.\n\n## Developer Tools\n\n| Tool | Purpose |\n| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| [Connector SDK](https://github.com/oomol-lab/connector-sdk) | Thin TypeScript HTTP client. Use `OpenConnector` for self-hosted runtimes, or `Connector` / `ProjectConnector` for OOMOL-hosted personal and SaaS end-user connections. |\n| [oo CLI](https://github.com/oomol-lab/oo-cli) | Local agent relay for connector Actions. `oo connector` can search, inspect, and run Actions against OOMOL-hosted or self-hosted OpenConnector runtimes. |\n| MCP | Expose app Actions to MCP-capable agent hosts through `http://localhost:3000/mcp`. |\n| HTTP / OpenAPI | Call `/v1/actions/*` directly or inspect the generated `/openapi.json` document. |\n\nEndpoint details, response envelopes, auth headers, MCP tools, and Action guide examples are in\n[docs/runtime-api.md](docs/runtime-api.md).\n\n## Dashboard Preview\n\nOpenConnector ships with a local Dashboard for browsing connectors, configuring credentials,\ncreating runtime tokens, and inspecting runtime usage.\n\n### Connector Catalog\n\nUse the connector catalog to see available services, search for providers, and open their Actions\nand credential setup from one place.\n\n![OpenConnector connector catalog dashboard](assets/open-console-en.jpg)\n\n### Usage Overview\n\nUse the Overview page after deployment to monitor runtime readiness, available providers,\nexecutable Actions, recent failures, tool call trends, and recent calls.\n\n![OpenConnector runtime overview dashboard](assets/overview-page-en.jpg)\n\nProvider names and trademarks belong to their respective owners and are used only for identification\nand interoperability.\n\n## How It Works\n\n```mermaid\nflowchart LR\n Agent[\"AI Agent / App\"] -->|\"SDK / CLI / MCP / HTTP\"| Gateway[\"OpenConnector Gateway\"]\n Gateway --> Auth[\"Credential & OAuth Boundary\"]\n Gateway --> Catalog[\"Provider Catalog\"]\n Gateway --> Actions[\"Open-source Action Executors\"]\n Gateway --> Policy[\"Tokens, Scopes, Allow/Block Policy\"]\n Gateway --> Logs[\"Run Logs\"]\n Actions --> Providers[\"1,000+ Providers\"]\n Console[\"Web Console\"] --> Gateway\n Cloudflare[\"Cloudflare Workers, D1, R2\"] -. deploy .-> Gateway\n```\n\nApps and agents discover Actions, inspect schemas and scopes, select a connection alias, and execute\nthrough the gateway. Provider secrets stay behind the runtime boundary; agents receive the metadata,\nsafe account labels, and execution results needed for the run.\n\n## Usage Paths\n\n| Path | Best for | Includes |\n| ------------------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Open-source self-host | Developers and teams that want full control | Local Docker or Node runtime, SQLite storage, MCP, HTTP, OpenAPI, and Web Console |\n| Fly.io self-host | Teams that want a hosted Docker runtime | Node Docker runtime, SQLite storage on a Fly volume, TLS, health checks, MCP, HTTP, OpenAPI, and Web Console |\n| Cloudflare-compatible deploy | Teams that want a lightweight hosted runtime | Workers runtime, D1 state, R2 transit files, and Static Assets for the console |\n| [OOMOL](https://oomol.com/apps) | Teams that want users to authorize accounts immediately | OOMOL-provided OAuth apps, monthly included Connect credits, and hosted runtime infrastructure; the same provider and Action contracts keep a path open to later private or self-hosted deployment |\n\n## Cloudflare Quick Start Video\n\n[![Deploy OpenConnector on Cloudflare Workers](assets/cloudflare-quickstart-video.png)](https://www.youtube.com/watch?v=R0V1ZdCuTgc)\n\nThe\n[Cloudflare Workers deployment walkthrough](https://www.youtube.com/watch?v=R0V1ZdCuTgc) shows how\nto launch OpenConnector on Cloudflare with Workers, D1, R2, and the Web Console. The video follows\nthe same flow as [docs/cloudflare.md](docs/cloudflare.md): create Cloudflare resources, copy\n`wrangler.example.jsonc` to `wrangler.local.jsonc`, apply D1 migrations, set required secrets, and\nrun `npm run deploy:cloudflare`.\n\n## Quick Start\n\n> [!NOTE]\n> This starts a self-hosted runtime. OAuth providers require OAuth client credentials from apps you\n> register with those providers. To let users authori","default_branch":"main","files":5464,"tree":[".codex/skills/add-provider/SKILL.md",".dockerignore",".github/workflows/ci.yml",".github/workflows/pr-maintainer-edits.yml",".github/workflows/publish-docker.yml",".github/workflows/star-history.yml",".gitignore",".oxfmtrc.json",".oxlintrc.json","AGENTS.md","CODE_OF_CONDUCT.md","CONTRIBUTING.md","LICENSE.txt","NOTICE.md","README.md","SECURITY.md","assets/cloudflare-quickstart-video.png","assets/create-runtime-token.png","assets/deployment-options/cloudflare.svg","assets/deployment-options/oomol.svg","assets/deployment-options/self-hosted.svg","assets/gmail-connect.png","assets/gmail-connected.png","assets/gmail-oauth-client.png","assets/open-console-en.jpg","assets/open-console-zh.jpg","assets/openconnector-readme-banner.png","assets/overview-page-en.jpg","assets/overview-page-zh.jpg","assets/star-history/.star-history.sig","assets/star-history/star-history-dark.svg","assets/star-history/star-history-light.svg","assets/star-history/star-history.png","assets/star-open-connector.gif","docker-compose.build.yml","docker-compose.yml","docker/Dockerfile","docs/README.fr.md","docs/README.ja.md","docs/README.ko.md","docs/README.ru.md","docs/README.zh-CN.md","docs/README.zh-TW.md","docs/catalog-format.md","docs/cloudflare.md","docs/configuration.md","docs/credentials.md","docs/docker-ghcr.md","docs/docker-ghcr.zh-CN.md","docs/fly-io.md","docs/gmail-oauth-sdk.md","docs/gmail-oauth-sdk.zh-CN.md","docs/quickstart.md","docs/runtime-api.md","docs/sdk-cli.md","docs/verification.md","examples/aliyun-sls-query-logs.ts","examples/local-http/README.md","examples/local-http/client.ts","examples/local-http/github.ts","examples/local-http/gmail.ts","examples/local-http/hackernews.ts","examples/local-http/notion.ts","examples/mcp-client/README.md","examples/mcp-client/list-tools.ts","examples/openai-tools/README.md","examples/openai-tools/list-tools.ts","examples/openai-tools/run-hackernews.ts","examples/tsconfig.json","fly.toml","migrations/0001_runtime.sql","migrations/0002_run_service.sql","migrations/0003_action_idempotency.sql","migrations/0004_action_run_audit.sql","migrations/0005_run_retention.sql","migrations/0006_connection_identity.sql","migrations/0007_runtime_policy.sql","migrations/0008_runtime_token_policy.sql","migrations/0009_runtime_token_proxy.sql","migrations/0010_connection_revision.sql","package-lock.json","package.json","scripts/copy-catalog-assets.test.ts","scripts/copy-catalog-assets.ts","scripts/dev-local.ts","scripts/ensure-generated.ts","scripts/export-feishu-permissions.ts","scripts/generate-catalog.ts","scripts/generate-provider-registry.ts","scripts/generate-provider.ts","scripts/healthcheck.ts","scripts/provider-source.ts","scripts/runtime-data.ts","scripts/search-actions.ts","scripts/tsconfig.build.json","scripts/tsconfig.json","scripts/typecheck.ts","src/catalog-store.test.ts","src/catalog-store.ts","src/connection-service.test.ts","src/connection-service.ts","src/core/action-policy.test.ts","src/core/action-policy.ts","src/core/action-search.test.ts","src/core/action-search.ts","src/core/cast.test.ts","src/core/cast.ts","src/core/catalog.ts","src/core/credential-fields.ts","src/core/execution.test.ts","src/core/execution.ts","src/core/guarded-fetch-default-lookup.test.ts","src/core/guarded-fetch.test.ts","src/core/guarded-fetch.ts","src/core/guarded-websocket.test.ts","src/core/guarded-websocket.ts","src/core/json-schema.test.ts","src/core/json-schema.ts","src/core/provider-definition.ts","src/core/provider-id.test.ts","src/core/provider-id.ts","src/core/request.test.ts","src/core/request.ts","src/core/types.ts","src/core/validation.test.ts","src/core/validation.ts","src/mail/imap-smtp/actions.ts","src/mail/imap-smtp/config.ts","src/mail/imap-smtp/errors.ts","src/mail/imap-smtp/host-pinning.test.ts","src/mail/imap-smtp/protocol.ts","src/mail/imap-smtp/runtime.test.ts","src/mail/imap-smtp/runtime.ts","src/mail/imap-smtp/temp-files.ts","src/mcp.test.ts","src/mcp.ts","src/oauth/oauth-client-config-service.test.ts","src/oauth/oauth-client-config-service.ts","src/oauth/oauth-credential-refresh-service.test.ts","src/oauth/oauth-credential-refresh-service.ts","src/oauth/oauth-flow-service.test.ts","src/oauth/oauth-flow-service.ts","src/oauth/oauth-token.test.ts","src/oauth/oauth-token.ts","src/providers/17track/actions.ts","src/providers/17track/definition.ts","src/providers/17track/executors.ts","src/providers/17track/runtime.ts","src/providers/7_shifts/actions.ts","src/providers/7_shifts/definition.ts","src/providers/7_shifts/executors.ts","src/providers/7_shifts/runtime.ts","src/providers/a_leads/actions.ts","src/providers/a_leads/definition.ts","src/providers/a_leads/executors.ts","src/providers/ablefy/actions.ts","src/providers/ablefy/definition.ts","src/providers/ablefy/executors.ts","src/providers/ably/actions.ts","src/providers/ably/definition.ts","src/providers/ably/executors.ts","src/providers/ably_control/actions.ts","src/providers/ably_control/definition.ts","src/providers/ably_control/executors.ts","src/providers/abstract/actions.ts","src/providers/abstract/definition.ts","src/providers/abstract/executors.ts","src/providers/abuseipdb/actions.ts","src/providers/abuseipdb/definition.ts","src/providers/abuseipdb/executors.ts","src/providers/abyssale/actions.ts","src/providers/abyssale/definition.ts","src/providers/abyssale/executors.ts","src/providers/accredible_certificates/actions.ts","src/providers/accredible_certificates/definition.ts","src/providers/accredible_certificates/executors.ts","src/providers/acculynx/actions.ts","src/providers/acculynx/definition.ts","src/providers/acculynx/executors.ts","src/providers/accuweather/actions.ts","src/providers/accuweather/definition.ts","src/providers/accuweather/executors.ts","src/providers/accuweather/runtime.ts","src/providers/active_trail/actions.ts","src/providers/active_trail/definition.ts","src/providers/active_trail/executors.ts","src/providers/activecampaign/actions.ts","src/providers/activecampaign/definition.ts","src/providers/activecampaign/executors.ts","src/providers/adafruit_io/actions.ts","src/providers/adafruit_io/definition.ts","src/providers/adafruit_io/executors.ts","src/providers/addressfinder/actions.ts","src/providers/addressfinder/definition.ts","src/providers/addressfinder/executors.ts","src/providers/addresszen/actions.ts","src/providers/addresszen/definition.ts","src/providers/addresszen/executors.ts","src/providers/adobe_commerce/actions.ts","src/providers/adobe_commerce/definition.ts","src/providers/adobe_commerce/executors.ts","src/providers/adyen/actions.ts","src/providers/adyen/definition.ts","src/providers/adyen/executors.ts","src/providers/adyntel/actions.ts","src/providers/adyntel/definition.ts","src/providers/adyntel/executors.ts","src/providers/adyntel/runtime.ts","src/providers/aerisweather/actions.ts","src/providers/aerisweather/definition.ts","src/providers/aerisweather/executors.ts","src/providers/aerisweather/runtime.ts","src/providers/aeroleads/actions.ts","src/providers/aeroleads/definition.ts","src/providers/aeroleads/executors.ts","src/providers/affinda/actions.ts","src/providers/affinda/definition.ts","src/providers/affinda/executors.ts","src/providers/affinity/actions.ts","src/providers/affinity/definition.ts","src/providers/affinity/executors.ts","src/providers/affinity/runtime.ts","src/providers/aftership/actions.ts","src/providers/aftership/definition.ts","src/providers/aftership/executors.ts","src/providers/agent_mail/actions.ts","src/providers/agent_mail/definition.ts","src/providers/agent_mail/executors.ts","src/providers/agent_mail/runtime.ts","src/providers/agent_qq/actions.ts","src/providers/agent_qq/definition.ts","src/providers/agent_qq/executors.ts","src/providers/agentql/actions.ts","src/providers/agentql/definition.ts","src/providers/agentql/executors.ts","src/providers/agentql/runtime.ts","src/providers/agenty/actions.ts","src/providers/agenty/definition.ts","src/providers/agenty/executors.ts","src/providers/agenty/runtime.ts","src/providers/agiled/actions.ts","src/providers/agiled/definition.ts","src/providers/agiled/executors.ts","src/providers/agiled/runtime.ts","src/providers/agility/actions.ts","src/providers/agility/definition.ts","src/providers/agility/executors.ts","src/providers/agility/runtime.ts","src/providers/agora/actions.ts","src/providers/agora/definition.ts","src/providers/agora/executors.ts","src/providers/agora/runtime.ts","src/providers/ahrefs/actions.ts","src/providers/ahrefs/definition.ts","src/providers/ahrefs/executors.ts","src/providers/ahrefs/runtime.ts","src/providers/aifinmarket/actions.ts","src/providers/aifinmarket/definition.ts","src/providers/aifinmarket/executors.ts","src/providers/aifinmarket/runtime.ts","src/providers/aimfox/actions.ts","src/providers/aimfox/definition.ts","src/providers/aimfox/executors.ts","src/providers/airbrake/actions.ts","src/providers/airbrake/definition.ts","src/providers/airbrake/executors.ts","src/providers/aircall/actions.ts","src/providers/aircall/definition.ts","src/providers/aircall/executors.ts","src/providers/aircall/runtime.ts","src/providers/airtable/actions.ts","src/providers/airtable/definition.ts","src/providers/airtable/executors.test.ts","src/providers/airtable/executors.ts","src/providers/airtable/scopes.ts","src/providers/aivoov/actions.ts","src/providers/aivoov/definition.ts","src/providers/aivoov/executors.ts","src/providers/aivoov/runtime.ts","src/providers/alchemy/actions.ts","src/providers/alchemy/definition.ts","src/providers/alchemy/executors.ts","src/providers/alchemy/runtime.ts","src/providers/algo_docs/actions.ts","src/providers/algo_docs/definition.ts","src/providers/algo_docs/executors.ts","src/providers/algo_docs/runtime.ts","src/providers/algolia/actions.ts","src/providers/algolia/definition.ts","src/providers/algolia/executors.ts","src/providers/algolia/runtime.ts","src/providers/aliyun_oss/actions.ts","src/providers/aliyun_oss/definition.ts","src/providers/aliyun_oss/executors.ts","src/providers/aliyun_sls/actions.ts","src/providers/aliyun_sls/definition.ts","src/providers/aliyun_sls/executors.ts","src/providers/aliyun_sls/resources.ts","src/providers/aliyun_sls/runtime.ts","src/providers/aliyun_sls/signing.ts","src/providers/aliyun_sts/actions.ts","src/providers/aliyun_sts/definition.ts","src/providers/aliyun_sts/executors.ts","src/providers/aliyun_sts/runtime.ts","src/providers/alpaca/actions.ts","src/providers/alpaca/definition.ts","src/providers/alpaca/executors.test.ts","src/providers/alpaca/executors.ts","src/providers/alpaca/runtime.ts","src/providers/alpaca/scopes.ts","src/providers/alpha_vantage/actions.ts","src/providers/alpha_vantage/definition.ts","src/providers/alpha_vantage/executors.ts","src/providers/alpha_vantage/runtime.ts","src/providers/alt_text_ai/actions.ts","src/providers/alt_text_ai/definition.ts","src/providers/alt_text_ai/executors.ts","src/providers/alt_text_ai/runtime.ts","src/providers/alt_text_generator_ai/actions.ts","src/providers/alt_text_generator_ai/definition.ts","src/providers/alt_text_generator_ai/executors.ts","src/providers/altiria/actions.ts","src/providers/altiria/definition.ts","src/providers/altiria/executors.ts","src/providers/altoviz/actions.ts","src/providers/altoviz/definition.ts","src/providers/altoviz/executors.ts","src/providers/amap/actions.ts","src/providers/amap/definition.ts","src/providers/amap/executors.ts","src/providers/amap/runtime.ts","src/providers/amara/actions.ts","src/providers/amara/definition.ts","src/providers/amara/executors.ts","src/providers/amara/runtime.ts","src/providers/ambee/actions.ts","src/providers/ambee/definition.ts","src/providers/ambee/executors.ts","src/providers/ambee/runtime.ts","src/providers/ambient_weather/actions.ts","src/providers/ambient_weather/definition.ts","src/providers/ambient_weather/executors.ts","src/providers/ambient_weather/runtime.ts","src/providers/ambivo/actions.ts","src/providers/ambivo/definition.ts","src/providers/ambivo/executors.ts","src/providers/amilia/actions.ts","src/providers/amilia/definition.ts","src/providers/amilia/executors.ts","src/providers/amilia/runtime.ts","src/providers/amplemarket/actions.ts","src/providers/amplemarket/definition.ts","src/providers/amplemarket/executors.ts","src/providers/amplemarket/runtime.ts","src/providers/amplitude/actions.ts","src/providers/amplitude/definition.ts","src/providers/amplitude/executors.ts","src/providers/amplitude/runtime.ts","src/providers/anchor_browser/actions.ts","src/providers/anchor_browser/definition.ts","src/providers/anchor_browser/executors.ts","src/providers/anchor_browser/runtime.ts","src/providers/anrok/actions.ts","src/providers/anrok/definition.ts","src/providers/anrok/executors.ts","src/providers/anthropic/actions.ts","src/providers/anthropic/definition.ts","src/providers/anthropic/executors.ts","src/providers/anthropic_admin/actions.ts","src/providers/anthropic_admin/definition.ts","src/providers/anthropic_admin/executors.ts","src/providers/anydb/actions.ts","src/providers/anydb/definition.ts","src/providers/anydb/executors.ts","src/providers/anysearch/actions.ts","src/providers/anysearch/definition.ts","src/providers/anysearch/executors.ts","src/providers/anysearch/runtime.ts","src/providers/apaleo/actions.ts","src/providers/apaleo/definition.ts","src/providers/apaleo/executors.ts","src/providers/apaleo/runtime.ts","src/providers/api2pdf/actions.ts","src/providers/api2pdf/definition.ts","src/providers/api2pdf/executors.ts","src/providers/api_bible/actions.ts","src/providers/api_bible/definition.ts","src/providers/api_bible/executors.ts","src/providers/api_ninjas/actions.ts","src/providers/api_ninjas/definition.ts","src/providers/api_ninjas/executors.ts","src/providers/api_sports/actions.ts","src/providers/api_sports/definition.ts","src/providers/api_sports/executors.ts","src/providers/api_void/actions.ts","src/providers/api_void/definition.ts","src/providers/api_void/executors.ts","src/providers/apiflash/actions.ts","src/providers/apiflash/definition.ts","src/providers/apiflash/executors.ts"],"storefront":"/r/oomol-lab","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/oomol-lab/open-connector/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}