wtf is open-connector?

oomol-lab/open-connector — explained in plain English

Analysis updated 2026-05-18

★ 3,095TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

Mindmap

mindmap
  root((OpenConnector))
    What it does
      Connects agents to SaaS APIs
      Manages credentials safely
      Exposes prebuilt Actions
    Tech stack
      TypeScript
      Node.js
      Cloudflare Workers
      SQLite
    Access methods
      Connector SDK
      oo CLI
      MCP
      HTTP and OpenAPI
    Use cases
      Agent to SaaS integration
      Self hosted auth gateway
      Multi provider automation
    Audience
      Developers
      AI agent builders

mindmap root((OpenConnector)) What it does Connects agents to SaaS APIs Manages credentials safely Exposes prebuilt Actions Tech stack TypeScript Node.js Cloudflare Workers SQLite Access methods Connector SDK oo CLI MCP HTTP and OpenAPI Use cases Agent to SaaS integration Self hosted auth gateway Multi provider automation Audience Developers AI agent builders

Why would anyone build with this?

REASON 1

Give an AI agent safe access to a user's GitHub, Gmail, or Slack account without exposing their credentials.

REASON 2

Build an agent product that needs reusable, permissioned access to many different SaaS tools.

REASON 3

Self host a connector gateway locally, on Fly.io, or on Cloudflare Workers instead of using a hosted service.

REASON 4

Expose a catalog of prebuilt Actions to agent hosts through the Model Context Protocol.

What's in the stack?

TypeScriptNode.jsCloudflare WorkersSQLiteDocker

How it stacks up

	oomol-lab/open-connector	colbymchenry/codegraph	dakheera47/job-ops
Stars	3,095	3,101	3,124
Language	TypeScript	TypeScript	TypeScript
Setup difficulty	moderate	easy	moderate
Complexity	4/5	2/5	3/5
Audience	developer	developer	general

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Node.js 22 or newer and choosing a deployment target such as Docker, Fly.io, or Cloudflare Workers.

Use freely for any purpose, including commercial use, as long as you keep the required copyright and license notices.

Wtf does this do

OpenConnector is an open source gateway that lets AI agents and apps connect to over a thousand different online services, such as GitHub, Gmail, Notion, BigQuery, Google Analytics, Supabase, Airtable, and Slack, without giving the agent direct access to a user's login credentials. Instead of building a separate connection for every service an agent needs, a developer connects a user's account once through OpenConnector, and the agent can then call any of over ten thousand prebuilt Actions against that account through a shared catalog. The gateway sits between the agent and the outside service, holding onto API keys, OAuth logins, and other credentials in a runtime that keeps a record of what was done. Every Action has a defined request and response shape, a list of required permissions, and can be turned on or off through allow and block policies. Sensitive details in run logs are hidden, and temporary files used during a run are handled separately from permanent credential storage. Developers can reach OpenConnector in several ways depending on what they are building: a TypeScript SDK for calling it from app code, a command line tool called oo CLI that acts as a local relay for an agent, the Model Context Protocol for agent hosts that support it, or plain HTTP and OpenAPI calls for custom clients. A web console is included for browsing connected services, setting up credentials, creating runtime tokens, and watching recent activity and failures. The project can run in several ways: self hosted locally with Docker or Node.js and a SQLite database, hosted on Fly.io with persistent storage, deployed to Cloudflare Workers using D1 and R2 for storage, or used through OOMOL's own hosted version of the same system for teams that are not ready to run their own infrastructure. Whichever option is used, the provider ids, Action ids, and data shapes stay the same, so a project can start on the hosted version and move to self hosting later without rewriting how it talks to the gateway. The project is licensed under Apache 2.0.

Yoink these prompts

Prompt 1

Walk me through self hosting OpenConnector locally with Docker and its SQLite storage.

Prompt 2

Explain how OpenConnector keeps provider credentials away from the AI agent that uses them.

Prompt 3

Show me how to connect OpenConnector to an MCP-capable agent host at localhost:3000/mcp.

Prompt 4

Help me deploy OpenConnector to Cloudflare Workers using D1 and R2 storage.

Frequently asked questions