Integrations

Matrix OS connects to external services through Pipedream Connect. You authorize once via OAuth, and your AI agent can read emails, create calendar events, post to Slack, and more -- all from conversation.

Available Services

Connecting a Service

There are two ways to connect:

From Settings

Open Settings > Integrations. You'll see all available services with a Connect button. Click it, authorize in the popup, and the connection appears automatically.

From Conversation

Tell your agent what you need:

"Connect my Gmail"

The agent will give you an authorization link. Click it, authorize, done. The agent confirms once the connection is active.

You can also label connections for multiple accounts:

"Connect my work Gmail as Work Gmail"

Using Connected Services

Once connected, just ask naturally:

"What are my unread emails?" "Create a meeting with Alice tomorrow at 3pm" "Post 'deploy complete' to #engineering in Slack" "List my open GitHub issues in myorg/myrepo"

The agent uses two IPC tools under the hood:

• connect_service -- starts the OAuth flow for a service
• call_service -- calls an action on a connected service

Service Actions Reference

Gmail

Optional params: query (Gmail search syntax like is:unread, from:alice), maxResults, cc.

Google Calendar

Date params use ISO 8601 format: 2026-04-06T09:00:00Z.

Google Drive

GitHub

Slack

Discord

Multiple Accounts

You can connect multiple accounts for the same service. For example, a Work Gmail and a Personal Gmail. Use labels to differentiate:

"Send from my Work Gmail: email [email protected] about the Q2 report"

The agent uses the label parameter to target the right account. If no label is specified, the most recently connected account is used.

Managing Connections

View connections

"What services are connected?"

Or open Settings > Integrations to see all active connections with status indicators.

Disconnect a service

"Disconnect my GitHub"

Or click Disconnect in Settings. This revokes the OAuth credentials on Pipedream's side and removes the connection from your account.

Building Apps with Integrations

Apps you build can use connected services. When the agent creates an app that needs Gmail or Slack, the platform tracks which services each app requires:

{
  "name": "Morning Briefing",
  "integrations": {
    "required": ["gmail", "google_calendar"],
    "optional": ["slack"]
  }
}

If a required service isn't connected, the platform tells you what's missing and how to connect it.

How It Works (Architecture)

User -> Shell (Settings UI / Conversation)
         |
    Gateway (:4000)
    /api/integrations/*
         |
    Pipedream Connect SDK
    - OAuth token management
    - Actions API (component execution)
    - Credential storage
         |
    External Service APIs
    (Gmail API, GitHub API, Slack API, etc.)

1. Gateway hosts the integration REST API and manages the platform database (users, connections, apps)
2. Pipedream handles OAuth flows, credential storage, token refresh, and API execution
3. Kernel exposes connect_service and call_service as IPC tools for the agent
4. Shell provides the Settings UI for visual connection management

Error Handling

Common Workflows