---
title: "Open-source AI Agent Connectors · OpenConnector by OOMOL"
description: "Official website of OpenConnector by OOMOL. Self-host the open-source connector runtime, connect app accounts, and call Actions through SDK, CLI, MCP or HTTP."
canonical: "https://openconnector.io/"
language: "en"
last-updated: "2026-09-18"
---

[OPEN SOURCE · APACHE-2.0](https://github.com/oomol-lab/open-connector/blob/main/LICENSE.txt)

# 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.](https://openconnector.io/about/)

[Get Started](https://openconnector.io/#get-started) [GitHub5,799](https://github.com/oomol-lab/open-connector "GitHub count checked on 2026-09-18 06:15:33 (UTC).")

Prefer to skip deployment? [Use OOMOL↗](https://console.oomol.com/connections)

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

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

01

### Connect an account

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

02

### Discover an Action

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

03

### 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 →](https://openconnector.io/connectors/github/)

[View Source](https://github.com/oomol-lab/open-connector/tree/main/src/providers/github) [Use in OOMOL](https://console.oomol.com/connections/github)

### Gmail

Communication

Work with mail through scoped account access.

[Connector guide →](https://openconnector.io/connectors/gmail/)

[View Source](https://github.com/oomol-lab/open-connector/tree/main/src/providers/gmail) [Use in OOMOL](https://console.oomol.com/connections/gmail)

### Notion

Productivity

Connect pages and workspace knowledge to your tools.

[Connector guide →](https://openconnector.io/connectors/notion/)

[View Source](https://github.com/oomol-lab/open-connector/tree/main/src/providers/notion) [Use in OOMOL](https://console.oomol.com/connections/notion)

### Slack

Communication

Connect team conversations and channel workflows.

[Connector guide →](https://openconnector.io/connectors/slack/)

[View Source](https://github.com/oomol-lab/open-connector/tree/main/src/providers/slack) [Use in OOMOL](https://console.oomol.com/connections/slack)

### Airtable

Data & Spreadsheets

Make structured workspace data available to your agent.

[Connector guide →](https://openconnector.io/connectors/airtable/)

[View Source](https://github.com/oomol-lab/open-connector/tree/main/src/providers/airtable) [Use in OOMOL](https://console.oomol.com/connections/airtable)

### Google Sheets

Data & Spreadsheets

Work with spreadsheets through a shared Action interface.

[Connector guide →](https://openconnector.io/connectors/googlesheets/)

[View Source](https://github.com/oomol-lab/open-connector/tree/main/src/providers/googlesheets) [Use in OOMOL](https://console.oomol.com/connections/googlesheets)

[Explore Connectors](https://openconnector.io/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](https://openconnector.io/quickstart/)

TypeScript

```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

```bash
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

```bash
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

```text
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 ↗](https://openconnector.io/docs/clients/) [Use the SDK With OOMOL ↗](https://oomol.com/en/docs/connector-client/)

[SDK, CLI & API Guides](https://openconnector.io/docs/clients/)

## 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](https://openconnector.io/compare/)

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](https://openconnector.io/quickstart/#local) [Follow the self-hosting quickstart](https://openconnector.io/quickstart/#local)

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](https://console.oomol.com/connections) [Read the hosted connector guide](https://oomol.com/en/docs/connector/)

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 →](https://openconnector.io/about/)

### 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 →](https://openconnector.io/docs/self-hosting/)

### 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 →](https://openconnector.io/docs/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 →](https://openconnector.io/docs/clients/)

BUILT IN THE OPEN

## Read it. Run it. Make it yours.

Explore the runtime and provider executors, open an issue, or contribute a connector. The project is licensed under Apache-2.0.

Project definition · excerpt from the English README

> “OpenConnector is an open-source connector gateway for AI agents”

[OpenConnector README · OOMOL↗](https://github.com/oomol-lab/open-connector/blob/4d7d59de1f6d474a1afb6194de008a0affc08b10/README.md)

[5,799 stars from the GitHub community.](https://github.com/oomol-lab/open-connector/stargazers "GitHub count checked on 2026-09-18 06:15:33 (UTC).")

[View on GitHub](https://github.com/oomol-lab/open-connector) [Contribute](https://github.com/oomol-lab/open-connector/blob/main/CONTRIBUTING.md)

[Report an Issue](https://github.com/oomol-lab/open-connector/issues) [Read the License](https://github.com/oomol-lab/open-connector/blob/main/LICENSE.txt)