OpenConnector: the open-source gateway for AI agents.

OpenConnector is an Apache-2.0 open-source connector runtime maintained by OOMOL that connects AI agents to application APIs. It manages account connections and credentials and exposes Actions through SDK, CLI, MCP or HTTP. Run it yourself or choose OOMOL hosting.

OpenConnector is the open-source connector runtime maintained by OOMOL. This is its official project website: openconnector.io.

Get Started GitHub

Prefer to skip deployment? Use OOMOL↗

Self-hostable
Inspectable Actions
SDK · CLI · MCP · HTTP

THE LOCAL CONSOLE

See what your agent can use.

Browse providers, configure connections, and inspect Actions in the console included with OpenConnector.

View the Project

Interactive console preview · Selected apps, not a connected account or a live runtime.

HOW IT WORKS

A clear boundary between agents and apps.

Agents discover what they can call. The gateway checks access and runs the Action. Provider credentials stay inside the runtime.

Your Agent / App

OpenConnector

Credentials · Scopes · Policies · Run logs

Connected Apps

Connect an account

Configure an API key or authorize an OAuth connection. Keep account credentials behind the gateway.

Discover an Action

Inspect input schemas, required scopes, and connection identity before a call.

Execute with control

Use runtime tokens and Action policies, then inspect redacted execution logs.

CONNECTOR CATALOG

The apps your work already lives in.

Explore a few familiar providers. Open their source, or connect an account with OOMOL.

GitHub

Developer Tools

Bring repository and issue workflows into your agent.

Connector guide →

View Source Use in OOMOL

Gmail

Communication

Work with mail through scoped account access.

Connector guide →

View Source Use in OOMOL

Notion

Productivity

Connect pages and workspace knowledge to your tools.

Connector guide →

View Source Use in OOMOL

Slack

Communication

Connect team conversations and channel workflows.

Connector guide →

View Source Use in OOMOL

Airtable

Data & Spreadsheets

Make structured workspace data available to your agent.

Connector guide →

View Source Use in OOMOL

Google Sheets

Data & Spreadsheets

Work with spreadsheets through a shared Action interface.

Connector guide →

View Source Use in OOMOL

Explore Connectors

DEVELOPER TOOLS

One Action model. Your choice of tools.

Start with a public Hacker News Action, then connect the apps you need. The SDK and CLI support self-hosted and OOMOL-hosted runtimes.

Read the Docs

TypeScript

import { OpenConnector } from "@oomol-lab/connector";

const connector = new OpenConnector({
  baseUrl: "http://localhost:3000",
  runtimeToken: process.env.OOMOL_CONNECT_RUNTIME_TOKEN,
});

const stories = await connector.hackernews.get_top_stories({});
console.log(stories);

Install @oomol-lab/connector first. This example calls a running local OpenConnector instance from Node.js.

CLI

oo connector login http://localhost:3000
oo connector search "Hacker News"
oo connector schema hackernews.get_top_stories
oo connector run hackernews --action get_top_stories --data '{}'

Install oo CLI, then point its connector commands at your local runtime. Authenticated deployments also require a runtime token.

HTTP

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

Run this read-only, no-auth Action against a local runtime. Add your runtime bearer token if authentication is enabled.

MCP

http://localhost:3000/mcp

Use this HTTP MCP endpoint in a compatible agent host. Follow the runtime API guide for client authentication and supported tools.

SDK, CLI & API Guides ↗Use the SDK With OOMOL ↗

Ready to use. Open to make your own.

Start with prebuilt Actions, run the gateway on your infrastructure, and contribute the improvements you need.

Prebuilt Actions
Self-hostable gateway
Community contributions

Compare Capabilities & Deployment

START BUILDING

Choose where it runs.

Run OpenConnector on your infrastructure, or let OOMOL handle the hosted runtime and supported OAuth connections.

YOUR INFRASTRUCTURE

Run OpenConnector

For developers who want to own the runtime, storage, and configuration.

Start locally with Docker or Node.js.
Manage your own credentials and OAuth apps.
Inspect, extend, and deploy the source.

Run Locally Follow the self-hosting quickstart

SKIP DEPLOYMENT

Use OOMOL

For individuals and teams who want to connect apps and start calling Actions.

Use a hosted connector runtime.
Authorize supported apps with managed OAuth.
Connect through an agent, CLI, MCP, or SDK.

Connect Apps in OOMOL Read the hosted connector guide

Both paths share provider IDs, Action IDs, and schemas. Client setup and account authorization depend on the runtime you choose.

Questions about OpenConnector

What is OpenConnector?

OpenConnector by OOMOL is an open-source gateway between AI agents and app APIs. It manages account connections and exposes inspectable Actions through SDK, CLI, MCP and HTTP.

About the project →

Can I use it without OOMOL hosting?

Yes. Run the open-source runtime on your infrastructure and configure your own credentials and OAuth apps. OOMOL hosting is an optional way to use supported managed OAuth and a hosted runtime.

Self-host OpenConnector with Docker →

Is every catalog Action verified?

A catalog definition, a local executor and a successful upstream API call are different levels of evidence. Check the relevant Action, source revision and verification notes before relying on it.

Verification →

Can I switch runtimes by changing only a URL?

Provider IDs, Action IDs and schemas are shared where supported, but runtime tokens, account connections, OAuth configuration and client setup depend on the deployment. Follow the setup guide for the runtime you choose.

SDK & CLI →

BUILT IN THE OPEN