Skip to main content
An integration is how ModuleX talks to a service you already use — GitHub, Slack, Gmail, Notion, Salesforce, and many more. Once a service is connected, ModuleX can run its actions for you: open an issue, send a message, read a row, create a contact. You connect the service once, and every workflow and the Assistant can use it from then on.
🎬 MEDIA PLACEHOLDER · MX-MEDIA-4000 · [SCREENSHOT] [SCREENSHOT_DESCRIPTION]: The ModuleX integration catalog: a grid of integration cards with logos, names, and a category filter. [SCREENSHOT_DETAILS]: Capture the integrations catalog page in the ModuleX app. Show a grid of logo cards (for example GitHub, Slack, Gmail, Notion, Salesforce, HubSpot), the search box, and the category filter rail. 16:9, light theme, no personal data visible. Highlight the search and category controls.

​
Integrations and tools, in plain terms

Two words come up everywhere in ModuleX. They are easy to keep straight.

An integration

A connection to one external service — for example GitHub or Slack. It bundles the service’s logo, its actions, and how to authenticate to it.

A tool

One callable action a connected integration exposes — for example “create an issue” or “send a message.” A single integration usually offers many tools.
So you connect an integration once, and that unlocks all of its tools. ModuleX ships 175 integrations today, and together they expose 600+ tool actions you can call.
ModuleX has 175 integrations as of this writing. You may see other counts in older material — this is the current, verified figure.

​
Where you use integration tools

A connected tool is available in two places, and you do not have to choose up front.

In a workflow

Drop a tool node onto the canvas, pick the integration and the action, and the workflow calls it on every run. This is the reusable, repeatable path.

In the Assistant

Ask the Assistant in plain language. It finds the right tool among your connected integrations, calls it for you, and pauses for approval when an action is sensitive.
The catalog is shared. A service you connect for the Assistant is the same connection a workflow uses, and the credentials you store work for both.

​
Browse the catalog

The catalog is the home for every integration ModuleX can connect to. You can search by name and filter by category to find what you need.

Open the integration catalog

Browse all 175 integrations by category, see each one’s logo and description, and find the tools it offers.
Categories in the catalog are descriptive labels (such as productivity, developer tools, marketing, and CRM), and a single integration can appear under more than one. Use the search box if you already know the service you want.

​
Connect a service: credentials and BYOK

Before ModuleX can act on your behalf, you tell it how to authenticate to the service. ModuleX stores that connection as an encrypted credential scoped to your organization, so your whole team can reuse it without re-entering secrets. There are two ways a service authenticates, depending on what it supports.

OAuth (connect with a click)

For services that support it, you click Connect, sign in on the provider’s own page, and approve access. ModuleX never sees your password — it receives a scoped token. Many connectors use this flow, with PKCE where the provider supports it.

Bring your own key (BYOK)

For services that use API keys, you paste a key (or other fields the service needs) into ModuleX. The same idea applies to model and knowledge providers: connect your own provider account and your usage is billed directly by that provider, with no ModuleX markup.
Under the hood, an integration declares one or more auth schemas, and ModuleX shows you the right form for each. There are six schema variants in total — OAuth2, bearer token, API key, a ModuleX-managed key, custom, and internal — but as a user you simply see the connect button or the fields a service asks for.

How authentication and credentials work

See the full picture: OAuth flows, API keys, BYOK, and how ModuleX stores and resolves your credentials.
ModuleX-managed model and knowledge usage is metered in credits. BYOK usage is billed by the provider you connected, not by ModuleX. See credits and the billing model for the details.

​
Use a tool in a workflow

Connecting a service and using one of its tools takes a few steps. Here is the path from zero to a running tool call.
1

Find the integration in the catalog

Open the catalog, search for the service you want, and open it to see the tools it offers.
2

Connect it

Click Connect and either approve the OAuth flow or paste your API key. ModuleX saves the credential to your organization so it is reusable. See authentication and credentials.
3

Add a tool node to your workflow

In the workflow builder, add a tool node, then pick the integration and the specific action you want to run.
4

Map the inputs

Fill in the action’s parameters, pulling values from earlier nodes with references such as {{node_id.field}} where you need them.
5

Run it

Run the workflow. The tool node calls the service, and its result is written into run state for the next node to use.

The tool node, in depth

Learn how the tool node selects an action, maps parameters, and returns results inside a workflow.

​
Call a tool from your own code

You can also list the catalog programmatically — for example to discover which integrations exist before wiring up a run. Every request authenticates with Authorization: Bearer mx_live_… plus your X-Organization-ID header. See authentication. 
curl https://api.modulex.dev/integrations/tools \
  -H "Authorization: Bearer mx_live_your_api_key" \
  -H "X-Organization-ID: org_your_organization_id"
The catalog endpoint returns a list of integrations, each with its name, display_name, description, and categories:
Response
[
  {
    "name": "github",
    "display_name": "GitHub",
    "description": "GitHub repository and code management platform",
    "logo": "modulex:github-themed",
    "categories": ["Developer Tools & Infrastructure"],
    "integration_type": "tool",
    "version": "1.0.0"
  }
]
Listing the catalog requires the owner or admin role in the organization you pass in X-Organization-ID. The retired member role is not a current role — see roles and permissions.

​
A note on installing the package

If you are running ModuleX yourself, the integrations ship in a Python package that the runtime loads at startup. Installing it pulls in the core dependencies only.
ModuleX does not currently provide working install extras such as [all] or per-tool extras like [github,slack]. Those groups are not populated yet, so asking for them only emits a pip warning and installs the core package. Install the base package, then add any extra SDKs a specific tool needs by hand. See installing and using integrations for the current, accurate steps.

​
Where to go next

Integration catalog

Browse all 175 integrations by category and find the tools you need.

Authentication & credentials

Connect a service with OAuth or your own API key, and learn how ModuleX stores credentials.

The tool node

Call a connected integration’s action from inside a workflow.

Connect an integration

A step-by-step walkthrough: connect a service and call its tool from a workflow.