OpenConnector

Name: OpenConnector
Author: OOMOL Lab

Self-hosted auth gateway that runs prebuilt Actions across 1,000+ SaaS apps over MCP

By OOMOL Lab TypeScript Local · stdio, Streamable HTTP Developer tools Productivity Communication

GitHub npm Website

83 popularity score ★ 6.2k ↓ 2.4k/wk

Connect your client

Local (once it is running)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Opens the app, which asks before it adds the server.

Or add it by command or config

Claude CodeTerminal

claude mcp add --transport http openconnector http://localhost:3000/mcp

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "openconnector": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "openconnector": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.openconnector]
url = "http://localhost:3000/mcp"

Gemini CLITerminal

gemini mcp add --scope user --transport http openconnector http://localhost:3000/mcp

Local (container)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Opens the app, which asks before it adds the server. Then replace each <NAME> in its settings with your value.

Or add it by command or config

Claude CodeTerminal

claude mcp add openconnector -- docker run -d --name open-connector -p 3000:3000 -v open_connector_data:/app/data -e 'OOMOL_CONNECT_ORIGIN=<OOMOL_CONNECT_ORIGIN>' -e 'OOMOL_CONNECT_ENCRYPTION_KEY=<OOMOL_CONNECT_ENCRYPTION_KEY>' -e 'OOMOL_CONNECT_ADMIN_TOKEN=<OOMOL_CONNECT_ADMIN_TOKEN>' ghcr.io/oomol-lab/open-connector:latest

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "openconnector": {
      "command": "docker",
      "args": [
        "run",
        "-d",
        "--name",
        "open-connector",
        "-p",
        "3000:3000",
        "-v",
        "open_connector_data:/app/data",
        "-e",
        "OOMOL_CONNECT_ORIGIN=<OOMOL_CONNECT_ORIGIN>",
        "-e",
        "OOMOL_CONNECT_ENCRYPTION_KEY=<OOMOL_CONNECT_ENCRYPTION_KEY>",
        "-e",
        "OOMOL_CONNECT_ADMIN_TOKEN=<OOMOL_CONNECT_ADMIN_TOKEN>",
        "ghcr.io/oomol-lab/open-connector:latest"
      ]
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "openconnector": {
      "command": "docker",
      "args": [
        "run",
        "-d",
        "--name",
        "open-connector",
        "-p",
        "3000:3000",
        "-v",
        "open_connector_data:/app/data",
        "-e",
        "OOMOL_CONNECT_ORIGIN=<OOMOL_CONNECT_ORIGIN>",
        "-e",
        "OOMOL_CONNECT_ENCRYPTION_KEY=<OOMOL_CONNECT_ENCRYPTION_KEY>",
        "-e",
        "OOMOL_CONNECT_ADMIN_TOKEN=<OOMOL_CONNECT_ADMIN_TOKEN>",
        "ghcr.io/oomol-lab/open-connector:latest"
      ]
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "openconnector": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-d",
        "--name",
        "open-connector",
        "-p",
        "3000:3000",
        "-v",
        "open_connector_data:/app/data",
        "-e",
        "OOMOL_CONNECT_ORIGIN=<OOMOL_CONNECT_ORIGIN>",
        "-e",
        "OOMOL_CONNECT_ENCRYPTION_KEY=<OOMOL_CONNECT_ENCRYPTION_KEY>",
        "-e",
        "OOMOL_CONNECT_ADMIN_TOKEN=<OOMOL_CONNECT_ADMIN_TOKEN>",
        "ghcr.io/oomol-lab/open-connector:latest"
      ]
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.openconnector]
command = "docker"
args = ["run", "-d", "--name", "open-connector", "-p", "3000:3000", "-v", "open_connector_data:/app/data", "-e", "OOMOL_CONNECT_ORIGIN=<OOMOL_CONNECT_ORIGIN>", "-e", "OOMOL_CONNECT_ENCRYPTION_KEY=<OOMOL_CONNECT_ENCRYPTION_KEY>", "-e", "OOMOL_CONNECT_ADMIN_TOKEN=<OOMOL_CONNECT_ADMIN_TOKEN>", "ghcr.io/oomol-lab/open-connector:latest"]

Gemini CLITerminal

gemini mcp add --scope user openconnector docker -- run -d --name open-connector -p 3000:3000 -v open_connector_data:/app/data -e 'OOMOL_CONNECT_ORIGIN=<OOMOL_CONNECT_ORIGIN>' -e 'OOMOL_CONNECT_ENCRYPTION_KEY=<OOMOL_CONNECT_ENCRYPTION_KEY>' -e 'OOMOL_CONNECT_ADMIN_TOKEN=<OOMOL_CONNECT_ADMIN_TOKEN>' ghcr.io/oomol-lab/open-connector:latest

Settings 10

`OOMOL_CONNECT_ENCRYPTION_KEY`	Optional: Encrypts stored credentials and OAuth settings; without it they are kept in plaintext.
`OOMOL_CONNECT_ADMIN_TOKEN`	Optional: Bearer token protecting the admin API and web console.
`OOMOL_CONNECT_RUNTIME_TOKEN`	Optional: Bootstrap bearer token MCP and /v1 callers must send.
`OOMOL_CONNECT_ORIGIN`	Optional: Public origin used for OAuth redirect URLs; defaults to http://localhost:<PORT>.
`OOMOL_CONNECT_DATABASE_URL`	Optional: PostgreSQL URL; SQLite in the data directory is used when unset.
`OOMOL_CONNECT_DATA_DIR`	Optional: Directory for the SQLite database and transit files.
`OOMOL_CONNECT_ALLOWED_ACTIONS`	Optional: Comma-separated allowlist of executable Actions, e.g. service.*.
`OOMOL_CONNECT_BLOCKED_ACTIONS`	Optional: Comma-separated denylist of Actions.
`OOMOL_CONNECT_ALLOW_PRIVATE_NETWORK`	Optional: Lets provider connections reach private networks; false by default.
`PORT`	Optional: HTTP port, 3000 by default.

In a container, a setting goes in with -e NAME=value after docker run.

What it does

OpenConnector is a gateway made by OOMOL that sits between an agent and the web services a user already has accounts with. You connect each provider once (GitHub, Gmail, Notion, Slack, BigQuery, Airtable, Supabase and many more) with an API key or an OAuth sign-in, and the gateway stores those credentials and runs prebuilt Actions against the provider on the agent's behalf. The agent never receives the provider secrets, only account labels and the results of each run.

The MCP side is deliberately small. Instead of one tool per Action, it offers five discovery tools: the agent lists apps and connected accounts, searches the Action catalog, reads the guide and input schema for one Action, then executes it, optionally choosing a named connection such as a work account. The same Actions are also reachable over a plain HTTP API, a generated OpenAPI document, a TypeScript SDK and the oo CLI, and a web console handles credentials, runtime tokens, Action debugging and run logs.

You run it yourself from the Docker image, a single-file binary, Node.js from source, a Helm chart or Cloudflare Workers, with SQLite or PostgreSQL for state. OOMOL also sells a hosted version with its own OAuth apps already registered. The npm package of the same name is the embeddable runtime library for a Node.js or Bun application, not a standalone server.

What it needs

Runtime	Docker

Docker (multi-arch image for amd64 and arm64), or Node.js 22 or newer to run from source. An MCP client that can connect to a remote HTTP server and send an Authorization header. Your own accounts and API keys with each provider you want to use; OAuth providers also need an OAuth app you register with that provider, unless you use OOMOL's paid hosted runtime. PostgreSQL 15+ is optional.

Limits

The MCP endpoint accepts stateless POST JSON-RPC only and keeps no GET SSE stream open. MCP execute_action calls take no idempotency key, unlike the HTTP Action endpoint. Self-hosted, you must register your own OAuth apps for OAuth providers. Without OOMOL_CONNECT_ENCRYPTION_KEY, credentials and OAuth settings are stored in plaintext; if the key is lost, encrypted data cannot be recovered. PostgreSQL migrations must be run by hand before starting a version that needs them.

Who it suits

Suits teams building agent products that need many SaaS integrations behind one endpoint, with credentials, scopes and allow/block rules kept on a server they control and an audit log of every run. The five-tool design keeps an agent's tool list short however many providers are connected. It is more setup than a single-purpose server: you run a container, set secrets, and connect each provider yourself. If you only need one service, that service's own MCP server is simpler; if you do not want to register OAuth apps, the docs point to OOMOL's hosted connectors instead.

Tools 5

list_apps: Lists the provider apps available on the gateway and their default connection.
list_connections: Lists the connected accounts the caller may use, without any stored secrets.
search_actions: Searches the Action catalog for an operation to run.
get_action_guide: Returns the guide and input schema for one Action, with an example call.
execute_action: Runs an Action against a provider, optionally on a named connection.

Popularity

83 popularity score, on our list (the bar is 36)

★ 6.2k ↓ 2.4k/wk

GitHub stars	6,196	45.5 points
Stars in 30 days	+240	10 points
npm downloads, last week	2,369	27 points

Measured 2026-11-07. How the score works.

Where it is published

Code	oomol-lab/open-connector ★ 6.2k
npm	@oomol-lab/open-connector
Container	ghcr.io/oomol-lab/open-connector

What it can reach

Runs	On your machine
Reaches	The internet, Your account at a service, Sends messages, Files on your machine, A database, Your code
Changes things	Yes: it can write, send, create or delete
Sign-in	An API key or token
Licence	OpenConnector License (its licence file)
Latest version	1.9.9 GitHub release, 2026-11-05
Last code change	2026-11-07

The gateway runs on your machine or infrastructure (or on OOMOL's servers if you use the hosted service) and calls third-party APIs with the provider accounts you connect, so execute_action can read and change data in those accounts: sending mail, posting messages, editing repositories and records. Provider credentials stay in the gateway's database, encrypted only when OOMOL_CONNECT_ENCRYPTION_KEY is set, and are not returned to the agent. MCP callers authenticate with a bearer runtime token or JWT when one is configured; persistent tokens can be limited to chosen Actions and connections, and Actions can be allowed or blocked server-wide. Calls to private networks are refused unless enabled. Every run is logged with redacted details.

Over time

GitHub stars 6.2k +240 (+4 %)

6.2k6.0k

7 Oct 20267 Nov 2026

npm downloads a week 2.4k −2.4k (−50 %)

4.8k136

28 Sept 20267 Nov 2026

Before the site measured it, read from npm's daily download counts.

Popularity score 83 +10 (+14 %)

8345

7 Oct 20267 Nov 2026

What is rising across the directory

Sources

Page checked 2026-10-14.

Badge for your README

Shows this server's rank in its category, and stars for a server that runs on your machine. It updates every hour.

MarkdownREADME.md

[![OpenConnector on EveryMCPServer](https://everymcpserver.com/badge/open-connector.svg)](https://everymcpserver.com/servers/open-connector)

Connect your client

Add in one click

Or add it by command or config

Add in one click

Or add it by command or config

Settings 10

What it does

What it needs

Limits

Who it suits

Tools 5

Similar servers

OpenWork MCP Gateway

Pipedream MCP

Corsair

Pipedream MCP server

Agent Harness Kit

autocontext