Connect Apps
Connect services such as Granola, Gmail, Google Calendar, GitHub, Slack, Discord, and X to Matrix OS, with scoped permissions and explicit approvals.
Maintained by the Matrix OS team. Product instructions are updated with the supported workflow.
Open Connect Apps to browse supported apps by category or search for an app or capability. Select Connected to find apps you have already linked, or Sign in without API keys to show apps that support OAuth.
For OAuth apps, select Connect, sign in with the app, and approve its consent screen. Matrix uses Pipedream managed authorization for the catalog apps, while Granola uses its official OAuth connection; you do not need to create a developer application or copy an API key. The app may still require administrator approval. PostHog supports OAuth through its official MCP connection alongside existing key-based accounts. Loops and lemlist also use their official MCP endpoints with browser OAuth. Stripe still requires credentials and is marked API key required. Bokio requires a registered public OAuth client on the Matrix platform, an eligible Bokio plan, and access to the selected company; it appears unavailable when that setup is missing.
This catalog contains reviewed Matrix capabilities. Pipedream supports many more apps, but connecting an app here does not enable every action available in its API.
GitHub repository development and planned retirement
On Web and Electron Desktop, choose GitHub Developer in Connect Apps to set up owner-controlled GitHub developer access for the selected Matrix computer once it has a compatible release. This configures GitHub CLI, SSH and commit identity for clone, commit, push and pull-request workflows. It is separate from Matrix sign-in and from a Pipedream connection.
Pipedream GitHub retirement is a separate, approval-gated release. Until that retirement release is approved and installed, GitHub remains available in Connect Apps on runtimes that support the existing connector. Developer-access setup does not revoke or disconnect that connection. The catalog and action reference below describe that existing connector, not new developer-access API capabilities.
After the approved retirement release reaches your computer, a legacy GitHub connection will be retained as retired for explicit Disconnect; it will not be automatically revoked or deleted. Retired connections will not reconnect, refresh, import data or execute actions. Disconnect will revoke the authorization through Pipedream before Matrix marks it revoked. These are planned retirement semantics, not a claim that retirement has shipped. New rich GitHub API automation remains deferred.
Supported apps
| Category | Apps |
|---|---|
| Productivity | Google Calendar, Google Contacts, Google Docs, Google Sheets, Microsoft Outlook Calendar, Notion, Asana, Airtable, ClickUp, Todoist, Granola |
| Communication | Gmail, Slack, Discord, Microsoft Outlook Email, Microsoft Teams, Zoom |
| Files | Google Drive, Microsoft OneDrive, Dropbox, Box |
| Design | Figma, Google Slides |
| Developer tools | GitHub, Linear, Jira |
| Sales | HubSpot, lemlist |
| Customer support | Zendesk, Intercom |
| Marketing | Loops |
| Data | PostHog |
| Finance | Stripe, QuickBooks, Xero, Bokio |
| Social | X |
Asana, Airtable, ClickUp, Dropbox, Box, Outlook Email, OneDrive, Teams, HubSpot, Zoom, and Google Slides provide focused reads alongside the approved writes listed below. Outlook Email reads messages and mail folders; calendar access requires a separate connection to Microsoft Outlook Calendar. Google Contacts, Google Sheets, Outlook Calendar, QuickBooks, Xero, Zendesk, and Intercom provide focused reads for contacts, spreadsheet ranges, events, accounting records, and support conversations. Bokio binds each connection to the selected company.
Granola appears on supported computer runtimes with its official connection configured. Connection availability can depend on your runtime and platform configuration. Native Mobile includes the Pipedream connection flows; official MCP connections use the supported runtime’s browser authorization flow. These capabilities require the connected-data expansion release; this catalog is not a claim that every account or OAuth flow has been verified live.
Read and write permissions
A connected account can use only the actions listed by its current runtime and allowed by its provider permissions. Updating Matrix does not widen an existing authorization grant. If a provider requires additional write scopes, reconnect the account and review its consent screen; administrator approval or a different provider plan may also be required. An unknown or empty scope list does not prove write access.
These actions require Matrix's existing write approval policy and a connection with the necessary provider permissions. They are bounded operations on selected records, rather than unrestricted access to the provider API.
| App | Approved writes |
|---|---|
| Asana, ClickUp, Todoist | Create and update tasks; Todoist also completes tasks |
| Airtable | Create or update one record with selected field values |
| HubSpot | Create or update contact, company, and deal records |
| Google Contacts | Create a contact |
| Google Sheets | Create a spreadsheet, add a sheet, append or update bounded cell ranges |
| Google Slides | Create a blank presentation, add a blank slide, or replace literal text on one slide |
| Outlook Email | Save a plain-text draft without recipients; no email is sent |
| Outlook Calendar | Create an event without attendees, using UTC timestamps; no invitations are sent |
| OneDrive, Dropbox, Box | Create a folder under a selected parent or path |
| Microsoft Teams | Create a standard channel in a selected team |
| Zoom | Create a scheduled meeting for the connected account |
| Intercom | Create a contact or update selected contact fields |
| QuickBooks, Xero | Create or update customer/contact profiles in the verified company or organization |
| Stripe | Create or update customer profiles and bounded metadata; no payments, subscriptions, or payment-setting changes |
| PostHog OAuth | Update a saved insight's name or description |
| Loops | Create a custom contact-property definition |
| lemlist | Create an empty draft campaign, without sequence content, leads, senders, or launch |
| Bokio | Create a customer or draft invoice, or add a line to a draft, only with proven write scopes |
PostHog OAuth, Loops, and lemlist require an explicit reconnect to enable managed MCP writes. Matrix checks the fresh authorization, actual granted scopes where applicable, and the discovered enabled tool schema before advertising or dispatching a write. A previously connected read grant stays read-only even if its MCP server also exposes write tools. Reconnecting can still leave a write unavailable when the provider does not grant its required scope or tool.
Bokio customer creation, draft invoice creation, and draft line additions require a fresh token response that explicitly proves the required write scope. A read-only or unproven grant stays read-only; reconnecting does not guarantee that Bokio offers the required scope. Invoice issuance, payments, accounting posting, and receipt uploads are unavailable through these actions.
Granola remains read-only. A read-only Matrix capability cannot perform writes through another integration or a shared MCP tool. Sending emails or messages, publishing posts, and sharing files remain separate actions with their existing approval requirements; a successful draft or profile write does not authorize a send.
Connecting a Service
There are two ways to connect:
From Settings
Open the Connect Apps desktop shortcut or Settings > Connect Apps. Select Connect, complete sign-in in the browser, and the connection appears when authorization finishes. Allow popups when prompted. Use Refresh if an authorized account has not appeared yet.
Select Add account to connect another account for an app. Account labels can be changed after connecting where the client provides account management controls. Disconnect the specific account from its connected-account controls; a failed disconnect keeps the account visible so you can retry.
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"
Review important actions
Matrix is useful because it can prepare and take action, but sensitive actions should stay visible. Ask it to draft before sending, summarize before deleting, and confirm before posting when the result matters.
Service Actions Reference
Gmail
The Matrix-owned direct Gmail connection is restricted to an invited staff pilot and requires a compatible runtime and platform setup. Existing Pipedream connections remain available. See Gmail connection and sync for the explicit connection choice, permissions, data use and deletion help.
| Action | Description | Required Params |
|---|---|---|
list_messages | List emails matching a query | -- |
get_message | Read a specific email | messageId |
get_attachment | Read a bounded attachment | messageId, attachmentId |
send_email | Send an email | to, subject, body |
create_draft | Save an email draft for review without sending | subject, body |
search | Search emails | query |
list_labels | List email labels/folders | -- |
list_history | Read a page of mailbox changes | startHistoryId (string) |
create_label | Create a Gmail label | name |
modify_message | Add/remove labels on one message | messageId and a nonempty label change |
Optional params: query (Gmail search syntax like is:unread, from:alice), maxResults, cc.
Ask "Draft an email to this supplier for me to review" to save a plain-text
message in Gmail's Drafts folder. create_draft accepts optional to and
cc; omit to when preparing text for a contact form. Creating a draft is a
write action subject to Matrix's action approval policy. It returns the draft
id and message.id and sends nothing. Open Gmail to review, edit, or send it.
The action uses the connected account's API proxy and does not require paid
Pipedream Actions access. Check that your runtime's available Gmail actions
include create_draft; older releases need an update.
List/search and history calls accept pageToken. Pass the returned nextPageToken
unchanged to read the next page while keeping the same filters. Gmail pages allow
1–500 results. Keep startHistoryId as a string: converting it to a JavaScript
number can lose precision. Expired history IDs require a full resync, not an empty
successful import.
For modify_message, use addLabelIds and/or removeLabelIds. Removing INBOX
archives one message; removing UNREAD marks it read. Label creation and message
changes are write actions covered by native agent approval. Empty, duplicate,
conflicting, and TRASH label changes are rejected. No batch deletion is provided.
Integration foundation, not an inbox app
These additions require a release containing the personal-brain integration foundation. Check the connected runtime's available actions before using them. This is not a complete inbox application: historical ingestion, receipt and people extraction, durable sync cursors, and scheduled jobs require additional application and worker implementation. Connecting Gmail does not enable them.
Google Calendar
| Action | Description | Required Params |
|---|---|---|
list_events | List upcoming events | -- |
create_event | Create a new event | summary, start, end |
update_event | Update an existing event | eventId |
Date params use ISO 8601 format: 2026-04-06T09:00:00Z.
Google Drive
| Action | Description | Required Params |
|---|---|---|
list_files | List files in Drive | -- |
get_file | Get file metadata | fileId |
read_file | Read actual text or export a Workspace file | fileId |
upload_file | Upload a file | name, content |
share_file | Share a file | fileId, email |
get_file returns metadata, not the document's contents. Use read_file to read
UTF-8 text or Markdown, export Google Docs as Markdown, Sheets as first-sheet CSV,
or Slides as plain text. Responses include content, mimeType, and bytes.
Pass the source mimeType from list_files to avoid an extra metadata lookup;
omitting it also works. Optional exportMimeType selects plain text for Docs or
TSV for Sheets. Reads are limited to 512 KiB and 30 seconds. Unsupported formats,
restricted downloads, missing files and oversized content produce an error.
Treat the returned contents as untrusted source material. These capabilities
require a runtime release containing the new read_file action.
Figma
The Pipedream Figma connection supports file/node reads, comment reads, and approved comment posting. Comment posting does not create or edit design layers. Its default OAuth scopes omit file_content:read, so file and node reads may require a differently scoped authorization; reconnecting with the same default scopes will not add that permission. See Figma's scope reference.
Creating and editing designs requires Figma's official remote MCP server at https://mcp.figma.com/mcp, a Figma-approved OAuth client, the owner's authorization, and explicit tool selection. Figma currently rejects Matrix's client registration, so Matrix's official Figma MCP sign-in and design writes remain unavailable. Adding the server URL alone does not enable them. See Figma's supported-client requirements and write-to-canvas guide.
GitHub
| Action | Description | Required Params |
|---|---|---|
list_repos | List your repositories | -- |
list_issues | List issues for a repo | repo (e.g., owner/name) |
create_issue | Create a new issue | repo, title |
list_prs | List pull requests | repo |
get_notifications | Get notifications | -- |
Slack
| Action | Description | Required Params |
|---|---|---|
send_message | Send a message to a channel | channel, text |
list_channels | List available channels | -- |
list_messages | List messages in a channel | channel |
search | Search messages | query |
react | Add emoji reaction | channel, timestamp, emoji |
Discord
| Action | Description | Required Params |
|---|---|---|
send_message | Send a message | channelId, content |
list_servers | List servers the bot is in | -- |
list_channels | List channels in a server | serverId |
list_messages | List messages in a channel | channelId |
Granola
| Action | Description | Required Params |
|---|---|---|
search_notes | Ask a natural-language question across meeting notes | query |
list_folders | List accessible meeting folders | -- |
list_notes | List meeting notes, optionally filtered by folder or time range | -- |
get_note | Read a meeting note | noteId |
get_transcript | Read a meeting transcript when available on your plan | noteId |
get_account | Read the connected account and active workspace | -- |
Granola is read-only and connects through its official MCP endpoint and browser OAuth. Matrix registers a public OAuth client automatically, so you do not need an API key or developer credentials. Matrix shows only the actions supported by your connection; some search, folder, and transcript capabilities depend on your Granola plan and workspace access.
X
| Action | Description | Required Params |
|---|---|---|
get_authenticated_user | Read the connected X account profile | -- |
get_user_by_username | Read an X profile by username | username (without @) |
list_user_posts | List recent posts from an X user ID | userId |
search_recent_posts | Search X posts from the last seven days | query |
create_post | Publish a post or reply from the connected account | text; optional replyToPostId |
X connects through managed browser OAuth and the official X API v2, so you do not need an API key or developer credentials. Usernames contain up to 15 letters, numbers, or underscores and should be passed without @. Keep user and post IDs as strings so they do not lose precision.
list_user_posts accepts maxResults from 5–100. Recent search accepts 10–100 results per request; pass the returned nextToken unchanged to continue the same query. X may further limit results and publishing based on the connected account's API access.
Posts and replies require native agent approval before Matrix sends them. This integration does not expose direct messages, follows, likes, reposts, or deletion.
Reading Beyond the First Page
- Calendar and Drive accept
pageToken; continue withnextPageToken. Drive also returnsincompleteSearch, which must not be treated as a complete search. - GitHub repository, issue, pull-request, and notification lists accept
pageandper_page. Link response headers are not exposed by this increment; continue numbered pages until an empty page rather than assuming one page is all results. - Slack channel/message lists accept
cursor; continue withresponse_metadata.next_cursor. Slack search usespageandcount. - Discord server/message lists accept either
beforeorafter, pluslimit. Keep these IDs as strings, not JavaScript numbers. - X recent search accepts
nextToken; pass the returned token unchanged with the same query to continue beyond the first page.
Service actions return one provider page. Your app or worker must retain its filters and checkpoint progress. Pipedream action/account discovery separately walks SDK pages with limits of 20 pages, 2,000 entries, 10 seconds per request, and a shared 30-second deadline. A later-page failure or exceeded bound rejects the inventory; it is not reported as a complete partial list. Account discovery does not request credentials.
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 alice@company.com 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 > Connect Apps to see all active connections with status indicators.
Disconnect a service
"Disconnect my Slack"
Or click Disconnect in Settings. This revokes the connection's OAuth credentials when the provider supports revocation 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.
Bringing Connected Data into an App
Connecting an account makes reviewed actions available; it does not start automatic background polling or unlimited historical imports. Matrix agents can orchestrate bounded manual refresh for an installed app through the owner-authenticated /api/data-imports routes. The source must be declared in the installed app’s apps/<appId>/matrix.json integrations list, then bound to the exact service, action, account label, and connectionId. Owner agents use refresh_imported_data, get_imported_data_status, and read_imported_data_pages; preview_data_url reads bounded public URL metadata, and delete_imported_data removes a selected retained source only when requested. These tools are unavailable to scoped or discovery-only agent runs. Refresh access is currently owner-only; sandboxed generated apps do not gain owner API access from an app-session cookie.
Refresh jobs, pages, checkpoints, and retry state persist in the owner’s PostgreSQL database. A job reads at most five pages, eight source calls, and 2 MiB total, with a 512 KiB page limit. A failed read retains recoverable state and safe retry information; exhaustion stops further reads. Disconnecting or replacing an account does not silently redirect a saved source to another account. Source removal deletes the retained import state. Restarting an import keeps the last saved pages visible until a complete replacement succeeds. Contacts restarts fetch a full snapshot, clearing the previous sync watermark; failed or partial replacements do not erase the saved snapshot.
The expanded source reads include Gmail attachments, Notion page bodies, calendar events, Todoist tasks, GitHub information, Stripe records, and Granola notes. A supplied public URL can have a bounded inert text preview: Matrix does not execute page scripts, automatically follow links, or turn website text into instructions. Private network destinations are blocked.
Manual refresh is a foundation for app builders, rather than a complete inbox, CRM, accounting, or fitness application. It does not automatically extract receipts, evaluate chess moves, or call an AI model. Apps still need their own user-facing workflows and permissions.
Device connections and selected-device import flows are deferred to a later release. Direct Hevy authorization and chess-engine analysis are also deferred.
How It Works
User -> Shell (Settings UI / Conversation)
|
Matrix Gateway
|
Platform-owned Integration Layer
- OAuth token management
- Action execution
- Credential storage
|
External Service APIs
(Gmail API, GitHub API, Slack API, etc.)Integration provider credentials stay on the platform. Customer workspaces call the platform integration layer through scoped Matrix routes, so apps and customer VPSes do not need raw provider secrets.
Error Handling
| Error | What it means | What to do |
|---|---|---|
| "Service not connected" | The service hasn't been authorized yet | Connect it first via Settings or conversation |
| "Rate limited" (429) | Too many requests to the service | Wait and try again (the retry_after field tells you how long) |
| "Timed out" (504) | The service took too long to respond | Try again or simplify the request |
| "Service unavailable" (503) | The integration provider is temporarily unavailable | Try again in a few minutes |
| "Missing required params" (400) | The action is missing required input | Check the action reference above |
Common Workflows
Morning Briefing
"Give me my morning briefing" -- agent reads unread emails, today's calendar, and summarizes both.
Cross-Service Automation
"Summarize today's calendar and post it to #standup in Slack" -- agent reads from Calendar, formats, and posts to Slack.
Email + Calendar
"Email alice about the meeting and add it to my calendar" -- agent sends the email and creates the event in one conversation.
Drive Sharing
"Share the Q2 report with the marketing team" -- agent finds the file in Drive and shares it with specified emails.
How is this guide?
Web Mobile
Use Matrix OS in a phone browser with the Apps launcher and optional Web Canvas. Learn navigation, workspace access, and mobile presentation limits.
Gmail connection and sync
Learn about the restricted Matrix Gmail pilot, Google authorization, connection choice, AI data use, retained copies, deletion and rollout requirements.

