English | 简体中文 | 日本語 | Русский | Français

OpenConnector is an open-source connector gateway for AI agents and an alternative to Composio. Connect user app accounts once, then expose a shared catalog of 1,000+ providers and 9,400+ prebuilt Actions to agents and applications.

Use the Connector SDK from app code, oo CLI as the local-agent relay, MCP from agent hosts, HTTP/OpenAPI from custom clients, and the Web Console for administration and debugging.

• Keep credentials, scopes, schemas, policies, and run logs inside an inspectable runtime.
• Run locally, on Cloudflare-compatible infrastructure, or through OOMOL's hosted runtime.
• Use the same provider ids, Action ids, schemas, and contracts across open-source and commercial SaaS deployments.

What It Provides

• A working connector catalog across products such as GitHub, Gmail, Notion, BigQuery, Google Analytics, Supabase, Airtable, Slack, and more.
• Credential handling for API keys, OAuth2, custom credentials, and no-auth providers.
• Inspectable Action contracts: request/response schemas, required scopes, and lazy-loaded executor source.
• Runtime controls for connection identity, scopes, runtime tokens, action allow/block policies, temporary file transit, and redacted run logs.
• Deployment options for local Docker or Node.js, Cloudflare Workers with D1/R2/Static Assets, and OOMOL's hosted runtime.

Where It Fits

OpenConnector fits products where agents need durable access to the tools users already use, without handing provider credentials to the agent process.

• Agent products that need reusable access across work apps, developer tools, data systems, communication platforms, and AI services.
• Products adding agent workflows that need stable, inspectable Action contracts for user app access.
• Teams that want hosted auth for speed while keeping a path to private or self-hosted runtime control.

Developer Tools

Endpoint details, response envelopes, auth headers, MCP tools, and Action guide examples are in docs/runtime-api.md.

Local Console Preview

OpenConnector ships with a local Web Console for browsing providers, configuring credentials, creating runtime tokens, and inspecting runs.

Provider names and trademarks belong to their respective owners and are used only for identification and interoperability.

How It Works

flowchart LR
  Agent["AI Agent / App"] -->|"SDK / CLI / MCP / HTTP"| Gateway["OpenConnector Gateway"]
  Gateway --> Auth["Credential & OAuth Boundary"]
  Gateway --> Catalog["Provider Catalog"]
  Gateway --> Actions["Open-source Action Executors"]
  Gateway --> Policy["Tokens, Scopes, Allow/Block Policy"]
  Gateway --> Logs["Run Logs"]
  Actions --> Providers["1,000+ Providers"]
  Console["Web Console"] --> Gateway
  Cloudflare["Cloudflare Workers, D1, R2"] -. deploy .-> Gateway

Apps and agents discover Actions, inspect schemas and scopes, select a connection alias, and execute through the gateway. Provider secrets stay behind the runtime boundary; agents receive the metadata, safe account labels, and execution results needed for the run.

Usage Paths

Cloudflare Quick Start Video

The Cloudflare Workers deployment walkthrough shows how to launch OpenConnector on Cloudflare with Workers, D1, R2, and the Web Console. The video follows the same flow as docs/cloudflare.md: create Cloudflare resources, copy wrangler.example.jsonc to wrangler.local.jsonc, apply D1 migrations, set required secrets, and run npm run deploy:cloudflare.

Quick Start

Start the runtime with Docker Compose:

docker compose up --build

Open the local console and generated API reference:

http://localhost:3000
http://localhost:3000/docs

Run a no-auth Action to verify the runtime:

curl -s -X POST http://localhost:3000/v1/actions/hackernews.get_top_stories \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

See docs/quickstart.md for the full local setup, first provider connection, OAuth flow, and runtime settings.

Connect a Provider

GitHub is the simplest credentialed example because it can use a personal access token:

curl -s -X PUT http://localhost:3000/api/connections/github \
  -H 'content-type: application/json' \
  -d '{"authType":"api_key","values":{"apiKey":"github_pat_..."}}'

curl -s -X POST http://localhost:3000/v1/actions/github.get_current_user \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

For OAuth2 apps, named connections, credential encryption, token refresh, and action policies, see docs/credentials.md and docs/configuration.md.

Web Console

Open http://localhost:3000 after starting the runtime. The console supports provider browsing, API key and OAuth client configuration, runtime token creation, Action schema inspection, Action debugging, recent run review, and access to the generated OpenAPI and MCP metadata.

Cloudflare Deployment

OpenConnector can run on Cloudflare with Workers for the runtime, D1 for state, R2 for transit files, and Static Assets for the Web Console.

See docs/cloudflare.md for resource creation, migrations, secrets, local Worker preview, and remote deployment.

Want to Use It Directly?

The paths above are for teams integrating connectors into their own products, runtimes, or infrastructure. If you want to try the SaaS connection experience first, or use it directly in day-to-day work, you do not need to deploy OpenConnector or integrate the SDK, CLI, MCP, or HTTP API first.

Wanta is the desktop product entry point using the same shared 1,000+ SaaS/provider coverage. Connect accounts once, then use natural language to search, organize, create, and sync across connected tools.

Documentation

• Quickstart
• Developer tools
• Gmail OAuth and SDK tutorial
• Runtime API and MCP
• Cloudflare deployment
• Configuration
• Credentials and OAuth
• Catalog format
• Verification language
• Contributing
• Code of Conduct
• Security

Development

Use Node.js 22 or newer:

npm install
npm run build:web
npm run dev

Before opening a pull request:

npm run fix-check
npm test

Provider code lives under src/providers/<service>. See CONTRIBUTING.md for provider contribution rules.

License Scope

Unless otherwise noted, the source code, scripts, generated project scaffolding, tests, and documentation authored for this repository are licensed under the Apache License, Version 2.0. See LICENSE.txt.

The Apache-2.0 license for this repository does not grant rights to third-party products, providers, apps, APIs, trademarks, service marks, trade names, logos, icons, brand assets, documentation, screenshots, or other copyrighted materials owned by their respective holders.

Provider and app names, metadata, links, scopes, permissions, and optional logos/icons are included only to identify services and enable interoperability. All third-party brand and product rights remain with their respective owners. Inclusion in this catalog does not imply endorsement, sponsorship, partnership, certification, or verification by those owners.

If you contribute provider metadata or assets, only submit material you have the right to submit. Prefer linking to official public assets instead of copying brand files into this repository.

Community

Please keep issues and pull requests focused, respectful, and actionable. Participation in this project is governed by CODE_OF_CONDUCT.md.