oomol-lab/open-connector

What is it?

Key features

• 01Shared catalog of 1,000+ providers and prebuilt Actions
• 02Credential handling for API keys, OAuth2, custom credentials, and no-auth providers
• 03Action contracts with request/response schemas and required scopes
• 04Runtime tokens and allow/block policies for controlling agent access
• 05Access via TypeScript SDK, oo CLI, MCP, HTTP, and OpenAPI

Use cases

• Giving an AI agent access to GitHub, Gmail, or Notion without sharing provider tokens with the agent
• Adding agent workflows to a product that needs reusable access to user SaaS accounts
• Self-hosting a connector gateway on your own infrastructure with Docker, Kubernetes, or Cloudflare

Quick start

1. 1

   Start the runtime from the published image with Docker Compose

   docker compose up
2. 2

   Open the local console at http://localhost:3000 and the API reference at http://localhost:3000/docs

3. 3

   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":{}}'

Things to know

• !OAuth providers need OAuth client credentials from apps you register yourself, unless you use the OOMOL-hosted service.
• !Self-hosting requires you to manage storage, OAuth apps and infrastructure.

Topics

FAQ

What is open-connector?

Self-hosted auth gateway that lets AI agents call 1,000+ SaaS providers through SDK, CLI, MCP, HTTP, and OpenAPI without handing over credentials. OpenConnector is a connector gateway for AI agents and applications. Users connect their app accounts once, and the runtime exposes a shared catalog of providers and prebuilt Actions. Provider secrets stay inside the runtime boundary, while agents receive action metadata, safe account labels, and execution results.

Is open-connector free to use? What license does it have?

open-connector is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.

Is open-connector still maintained?

Actively maintained. The last commit to open-connector was on Oct 19, 2026.

What can I use open-connector for?

Giving an AI agent access to GitHub, Gmail, or Notion without sharing provider tokens with the agent Adding agent workflows to a product that needs reusable access to user SaaS accounts Self-hosting a connector gateway on your own infrastructure with Docker, Kubernetes, or Cloudflare

How do I install open-connector?

Start the runtime from the published image with Docker Compose: docker compose up Open the local console at http://localhost:3000 and the API reference at 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":{}}'

Where can I get open-connector?

The source code and installation instructions are on GitHub: https://github.com/oomol-lab/open-connector