Composio gives Claude Co-work access to over 1,000 apps via OAuth. Learn how to connect Gmail, Xero, Notion, and more to your scheduled AI agents.
What Composio Does for Your AI Agents #
When you build an AI agent, one of the first real-world problems you hit is authentication. You want your agent to read emails, update a spreadsheet, create a Notion page, or send an invoice — but every app has its own OAuth flow, API tokens, and permission scopes. Managing that across dozens of tools becomes a project on its own.
Composio solves that. It’s an integration layer that handles OAuth connections for over 1,000 applications, giving AI agents authenticated, ready-to-use access to tools like Gmail, Slack, Xero, HubSpot, GitHub, Notion, and hundreds more. Instead of building and maintaining API connections yourself, you point your agent at Composio and let it handle the authentication plumbing.
For Claude agents specifically — especially scheduled, autonomous ones — Composio is a significant enabler. This guide walks through exactly how to use Composio inside MindStudio’s Claude Co-work feature to connect your agents to real business tools.
Understanding Claude Co-work in MindStudio #
MindStudio’s Claude Co-work feature lets you run Claude-powered agents on a schedule, in the background, without any human triggering the run. Think of it as giving Claude a recurring job: check for new leads every hour, summarize your inbox each morning, sync data across systems nightly.
These agents aren’t just running Claude in isolation. They need to interact with the tools your business already uses. That’s where the Composio integration becomes essential.
With Composio connected, a Co-work agent running on a schedule can:
-
Read new emails in Gmail and route them based on content
-
Pull unpaid invoices from Xero and trigger follow-up workflows
-
Create or update pages in Notion based on external triggers
-
Sync data between CRMs, spreadsheets, and project management tools
-
Post updates to Slack channels based on conditions Claude evaluates
-
✕a coding agent
-
✕no-code
-
✕vibe coding
-
✕a faster Cursor
The one that tells the coding agents what to build.
The combination of Claude’s reasoning and Composio’s breadth of integrations means you can build agents that don’t just process information — they act on it, across the tools your team actually uses.
Prerequisites Before You Start #
Before connecting Composio to your Claude Co-work agent, make sure you have the following in place:
A MindStudio account— Free to start atmindstudio.ai** A Composio account**— Sign up at composio.dev; they have a free tier** The apps you want to connect**— You’ll need admin or owner access to the accounts you’re authorizing (e.g., your Gmail, your Xero organization, your Notion workspace)A basic understanding of what your agent should do— It helps to have a clear use case in mind before wiring up integrations
You don’t need to write any code. This entire setup works through MindStudio’s visual builder.
Step 1: Set Up Your Composio Account and Get Your API Key #
Start in Composio before touching MindStudio.
- Go to composio.devand create a free account - Once inside, navigate to the API Keys section in your dashboard settings - Generate a new API key and copy it somewhere safe — you’ll paste it into MindStudio in a moment
Composio’s dashboard also shows you all the apps you’ve connected. Right now it’ll be empty. You’ll add apps either through the Composio dashboard or directly through MindStudio’s interface once the integration is live.
Step 2: Connect Composio to MindStudio #
With your API key ready, open MindStudio and navigate to your workspace settings.
- From your MindStudio dashboard, go to Integrations or open the agent you want to configure - Find Composio in the integrations list — MindStudio has Composio available as a native connection - Paste your Composio API key when prompted
- Save the connection
Once authenticated, MindStudio can communicate with Composio on behalf of your agents. Any app you authorize through Composio becomes available as an action your Claude agent can call.
Step 3: Authorize the Apps You Need #
This is the step most people want to get right. Composio uses OAuth, so authorizing an app means going through that app’s standard login flow — exactly like when you sign in with Google.
Connecting Gmail
- Inside Composio’s dashboard (or through the MindStudio integration panel), click Add App - Search for Gmail and select it - Click Connect— you’ll be redirected to Google’s OAuth screen - Sign in with the Google account you want your agent to access
- Grant the permissions Composio requests (read emails, send emails, manage labels — depending on what your agent needs)
- You’ll be redirected back to Composio and see Gmail listed as a connected app
Your Claude Co-work agent can now read, search, and send emails through that Gmail account.
Connecting Xero
- From the same Add App flow, search forXero - Click Connect and complete Xero’s OAuth authorization - Select the Xero organization you want your agent to access (if you manage multiple)
- Confirm the permissions — typically read/write access to contacts, invoices, and accounts
Once connected, your agent can pull invoice data, check payment statuses, create bills, and query financial records from Xero without any additional configuration.
Connecting Notion
- Search for Notion in the app list - Click Connect and authorize through Notion’s OAuth screen - You’ll be asked to select which Notion pages or databases to share with the integration — be specific here to avoid over-permissioning
- Confirm access
Remy doesn't write the code. It manages the agents who do. #
Remy runs the project. The specialists do the work. You work with the PM, not the implementers.
With Notion connected, your agent can create, read, and update pages and database entries. This is useful for things like logging call notes, creating project briefs from templates, or syncing task status.
Other Apps Worth Connecting
Composio’s library includes apps across every major category. Some commonly used ones:
CRMs: HubSpot, Salesforce, PipedriveCommunication: Slack, Microsoft Teams, GmailFinance: Xero, QuickBooks, StripeProductivity: Notion, Airtable, Google Sheets, Trello, AsanaDevelopment: GitHub, Linear, JiraE-commerce: Shopify, WooCommerce
Connect the ones relevant to your use case. You don’t need to connect everything upfront.
Step 4: Build Your Claude Co-work Agent in MindStudio #
Now head back into MindStudio’s builder to wire everything together.
Create a New Agent
- From your MindStudio dashboard, click New Agent - Choose Scheduled Agent(or** Co-work Agent**depending on your MindStudio plan and interface version) - Name your agent something descriptive — e.g., “Daily Invoice Reminder” or “Inbox Triage Agent”
Add Claude as the AI Model
In the model selection step, choose Claude from the model library. MindStudio gives you access to multiple Claude versions without requiring your own Anthropic API key. Pick the version appropriate for your task — Claude 3.5 Sonnet is a strong default for most business automation tasks.
Configure Composio Actions
Inside the agent builder, you’ll see a panel for adding Actions or Tools. This is where Composio integrations appear.
- Click
Add Action orAdd Tool - Select
Composio as the source - Browse or search for the action you want — for example,
gmail.search_emails
,xero.list_invoices
, ornotion.create_page
- Configure the parameters for that action (e.g., which Gmail label to search, which date range for Xero invoices)
You can add multiple Composio actions to a single agent. A single Co-work agent might:
- Check Gmail for emails with a specific subject line
- Extract relevant data using Claude
- Create a Notion page summarizing the content
- Post a Slack notification
All of that is configurable inside one agent.
Write Your Claude Prompt
In the prompt section, give Claude clear instructions about what to do with the data it retrieves. Be specific:
- What should it look for?
- What decisions should it make?
- What should it output or trigger?
For example, a prompt for an invoice reminder agent might read: “You have access to Xero invoice data. Check for all invoices that are more than 14 days past due. For each one, draft a polite payment reminder email using the contact information from the invoice. Send each email via Gmail. Log a record of each reminder sent to the ‘Invoice Follow-ups’ database in Notion.”
Claude will follow those instructions using the Composio-powered actions you’ve configured.
Step 5: Set the Schedule #
Once your agent is built and tested, set it to run automatically.
- In the agent settings, find Schedule - Choose the frequency — hourly, daily, weekly, or a custom cron expression
- Set the time zone if relevant
- Save and activate
Your agent will now run on that schedule, using Claude’s reasoning and Composio’s integrations to work through its task without any manual trigger.
Real-World Use Cases #
Here are a few practical examples of what this combination can do:
Automated Lead Enrichment
- Trigger: New contact added to HubSpot
- Action: Claude pulls the contact’s domain, searches for company info via web tools, enriches the HubSpot record with company size and industry
- Output: Updated CRM record with no manual research needed
Remy doesn't build the plumbing. It inherits it. #
Other agents wire up auth, databases, models, and integrations from scratch every time you ask them to build something.
Remy ships with all of it from MindStudio — so every cycle goes into the app you actually want.
Daily Finance Summary
- Trigger: Every morning at 8am
- Action: Pull yesterday’s transactions from Xero, categorize them using Claude
- Output: A Notion page with a summary and a Slack message to the finance channel
Inbox Triage
- Trigger: Every hour during business hours
- Action: Search Gmail for unread emails, classify urgency using Claude
- Output: Urgent emails flagged with a label, a Slack DM sent to the relevant person
Content Publishing Workflow
- Trigger: A new row added to Airtable
- Action: Claude generates a draft based on the brief, formats it
- Output: Draft published to Notion for review, team notified in Slack
How MindStudio Handles This Without Code #
MindStudio is worth highlighting here because the setup described above doesn’t require a developer. The visual builder handles the Composio connection, the Claude configuration, and the scheduling in one interface.
Compared to building this yourself — managing OAuth tokens, writing API calls, handling retry logic, deploying a server to run scheduled jobs — MindStudio removes all of that infrastructure work. You get a working scheduled Claude agent with real app integrations in under an hour.
If you need to go beyond what the visual builder offers, MindStudio also supports custom JavaScript and Python functions, so developers can extend agents without switching to a different platform entirely.
For teams already using tools like [MindStudio’s AI workflow builder](https://mindstudio.ai), adding Composio integrations is a natural extension rather than a separate project. You can explore the full integration library and start building for free at [mindstudio.ai](https://mindstudio.ai).
Troubleshooting Common Issues #
OAuth Connection Fails
This usually happens when you don’t have the right permissions in the app you’re connecting. Make sure you’re signing in with an account that has admin or owner access — for Xero, that means organization admin; for Notion, workspace owner.
Agent Runs But No Actions Execute
Check that your Composio API key is still valid and hasn’t been regenerated. Also verify that the connected app’s OAuth token hasn’t expired — Composio handles token refresh in most cases, but some apps require periodic re-authorization.
Claude Isn’t Finding the Right Data
The most common cause is a prompt that’s too vague. Add specific field names, date ranges, or filter criteria to your instructions. If Claude is querying Xero for invoices, tell it exactly which status to filter for (e.g., “AUTHORISED” and “OVERDUE”), not just “unpaid invoices.”
Actions Are Available But Not Showing Up
In MindStudio, refresh the Composio integration connection. If the app was recently added to your Composio account, it may need a moment to sync with MindStudio’s interface.
FAQ #
What is Composio and how does it work with AI agents?
Composio is an integration platform that provides authenticated access to over 1,000 applications for AI agents. Instead of each agent managing its own OAuth flows and API connections, Composio centralizes authentication so agents can call tools like Gmail, Xero, Notion, and Slack using pre-built, managed connections. The agent sends a request to Composio, which handles authentication and makes the actual API call on the agent’s behalf.
Other agents ship a demo. Remy ships an app. #
Real backend. Real database. Real auth. Real plumbing. Remy has it all.
Does Composio work natively inside MindStudio?
Yes. MindStudio has native Composio support built into its integration panel. You connect your Composio API key once, and all of your authorized apps become available as actions inside any agent you build. You don’t need to configure each integration separately in both platforms.
What apps can I connect through Composio?
Composio supports over 1,000 apps including Gmail, Outlook, Slack, Microsoft Teams, HubSpot, Salesforce, Pipedrive, Xero, QuickBooks, Stripe, Notion, Airtable, Google Sheets, Trello, Asana, GitHub, Linear, Jira, Shopify, and many more. The full list is available in the Composio app directory.
Is it safe to give an AI agent access to my email or financial tools?
The safety of the setup depends on the permissions you grant and the instructions you give Claude. Composio’s OAuth flow lets you grant scoped permissions — for example, read-only access to Gmail rather than full send/delete access. It’s good practice to give your agent only the permissions it actually needs for the task, and to test the agent in a sandbox environment before running it against live business data.
How do I control what the agent does with the data it retrieves?
You control this through Claude’s prompt inside MindStudio. The prompt defines exactly what Claude should look for, what decisions it should make, and what actions it should take. Claude won’t do anything outside of what you instruct it to do and what tools you’ve explicitly connected. Being specific in your prompts — including edge cases and exclusion criteria — is the most effective way to keep agent behavior predictable.
Can I connect multiple accounts for the same app?
Yes, Composio supports multiple connected accounts per app. If you need your agent to access two separate Gmail inboxes or two Xero organizations, you can authorize both and specify which account to use when configuring each action in MindStudio.
Key Takeaways #
- Composio handles OAuth authentication for 1,000+ apps, removing the biggest friction point for building agents that interact with real business tools
- MindStudio’s Claude Co-work feature lets you run Claude-powered agents on a schedule — no manual trigger required
- Connecting apps like Gmail, Xero, and Notion takes minutes using Composio’s standard OAuth flow
- The combination of Claude’s reasoning and Composio’s integrations enables practical automations: inbox triage, invoice reminders, data syncing, and more
- MindStudio’s visual builder handles the entire setup — no code required, with the option to add custom logic if needed
Start building with Composio and Claude Co-work in MindStudio for free at mindstudio.ai.