Skip to main content

Configuring Sessions

Enable toolkits, set auth configs, and select connected accountsDocs

Custom MCP

Use tools from a remote MCP server in Composio sessionsDocs

Custom Tools and Toolkits

Define local tools that run in-process alongside remote Composio toolsDocs

Local sandbox

Run Composio tools in a sandbox you own (your filesystem, your shell, your security boundary), while Composio keeps managed auth and tool discovery.Docs

Proxy execute

Call any API endpoint on a toolkit from a session and let Composio inject the authenticated credentials for youDocs

Quickstart

Build an agent that discovers and runs Composio toolsDocs

Remote sandbox

A persistent Python sandbox where your agent writes code, calls tools programmatically, and processes dataDocs

Shared connections

Make a connected account usable by multiple users with a per-user access control listDocs

What is a session?

What Composio sessions do, and how they scope users, tools, toolkits, auth, MCP, and workbench stateDocs

Ahrefs

Public support knowledge for Ahrefs.Knowledge Base

Airtable

Public support knowledge for Airtable.Knowledge Base

Apollo

Public support knowledge for Apollo.Knowledge Base

Asana

Public support knowledge for Asana.Knowledge Base

Attio

Public support knowledge for Attio.Knowledge Base

Browser Tool

Public support knowledge for Browser Tool.Knowledge Base

Canva

Public support knowledge for Canva.Knowledge Base

Canvas

Public support knowledge for Canvas.Knowledge Base

ClickUp

Public support knowledge for ClickUp.Knowledge Base

Confluence

Public support knowledge for Confluence.Knowledge Base

Consumer and Developer Project Boundaries

Public support knowledge for Consumer and Developer Project Boundaries.Knowledge Base

Create Read-Only and Restricted Composio Sessions

Public guidance for limiting session tool access with tags, exact tool allowlists, OAuth scopes, and sandbox controls.Knowledge Base

Current Support FAQs

Public answers for recurring Composio support issues.Knowledge Base

Custom Connection Data Field Names

Public support knowledge for Custom Connection Data Field Names.Knowledge Base

Dashboard Log Storage

Public behavior of the project Log storage setting.Knowledge Base

Databricks

Public support knowledge for Databricks.Knowledge Base

Debug Platform tools, triggers, users, and sessions

Current dashboard paths for inspecting Platform execution state and support identifiers.Knowledge Base

Discord Bot

Public support knowledge for Discord Bot.Knowledge Base

Dropbox

Public support knowledge for Dropbox.Knowledge Base

Excel

Public support knowledge for Excel.Knowledge Base

Facebook

Public support knowledge for Facebook.Knowledge Base

Fathom

Public support knowledge for Fathom.Knowledge Base

Figma

Public support knowledge for Figma.Knowledge Base

File Download Storage and Expiry

Public guidance for staged files, signed download URLs, retention, and size questions.Knowledge Base

Firecrawl

Public support knowledge for Firecrawl.Knowledge Base

Gemini

Public support knowledge for Gemini.Knowledge Base

GitHub

Public support knowledge for GitHub.Knowledge Base

Gmail

Public support knowledge for Gmail.Knowledge Base

Gong

Public support knowledge for Gong.Knowledge Base

Google Ads

Public support knowledge for Google Ads.Knowledge Base

Google Analytics

Public support knowledge for Google Analytics.Knowledge Base

Google Calendar

Public support knowledge for Google Calendar.Knowledge Base

Google Classroom

Public OAuth and connection troubleshooting for Google Classroom.Knowledge Base

Google Docs

Public support knowledge for Google Docs.Knowledge Base

Google Drive

Public support knowledge for Google Drive.Knowledge Base

Google Maps

Public support knowledge for Google Maps.Knowledge Base

Google Meet

Public support knowledge for Google Meet.Knowledge Base

Google Sheets

Public support knowledge for Google Sheets.Knowledge Base

Google Slides

Public support knowledge for Google Slides.Knowledge Base

Google Super

Public support knowledge for Google Super.Knowledge Base

Google Tasks

Public OAuth, connection, and quota troubleshooting for Google Tasks.Knowledge Base

Granola MCP

Public behavior and schema guidance for the official Granola MCP server.Knowledge Base

Hermes MCP

Public support knowledge for Hermes MCP.Knowledge Base

HubSpot

Public support knowledge for HubSpot.Knowledge Base

Instagram

Public support knowledge for Instagram.Knowledge Base

Intercom

Public support knowledge for Intercom.Knowledge Base

Jira

Public support knowledge for Jira.Knowledge Base

Kickbox

Public support knowledge for Kickbox.Knowledge Base

Klaviyo

Public support knowledge for Klaviyo.Knowledge Base

LaunchDarkly

Public support knowledge for LaunchDarkly.Knowledge Base

Linear

Public trigger configuration guidance for Linear.Knowledge Base

LinkedIn

Public support knowledge for LinkedIn.Knowledge Base

Mailchimp

Public support knowledge for Mailchimp.Knowledge Base

Marketstack

Public support knowledge for Marketstack.Knowledge Base

Microsoft Teams

Public support knowledge for Microsoft Teams.Knowledge Base

Monday

Public support knowledge for Monday.Knowledge Base

Move a Composio Integration from Prototype to Production

Public guidance for production user identity, environment isolation, authentication, sessions, and trigger delivery.Knowledge Base

Notion

Public support knowledge for Notion.Knowledge Base

Odoo

Public troubleshooting guidance for Odoo tools.Knowledge Base

OneDrive

Public support knowledge for OneDrive.Knowledge Base

OpenAI

Public support knowledge for OpenAI.Knowledge Base

Outlook

Public support knowledge for Outlook.Knowledge Base

Pipedrive

Public support knowledge for Pipedrive.Knowledge Base

Platform API Rate Limits

Public guidance for organization-level Composio API limits and 429 handling.Knowledge Base

Platform Pagination

Public guidance for endpoint-specific list limits and cursor pagination.Knowledge Base

PostHog

Public support knowledge for PostHog.Knowledge Base

Project API Key Permissions

Public guidance for scoped Project API key permissions.Knowledge Base

QuickBooks

Public support knowledge for QuickBooks.Knowledge Base

Reddit

Public support knowledge for Reddit.Knowledge Base

Salesforce

Public support knowledge for Salesforce.Knowledge Base

SerpApi

Public support knowledge for SerpApi.Knowledge Base

SharePoint

Public support knowledge for SharePoint.Knowledge Base

Shopify

Public support knowledge for Shopify.Knowledge Base

Slack

Public support knowledge for Slack.Knowledge Base

Slackbot

Public support knowledge for Slackbot.Knowledge Base

Snowflake

Public support knowledge for Snowflake.Knowledge Base

Spotify

Public support knowledge for Spotify.Knowledge Base

Stripe

Public support knowledge for Stripe.Knowledge Base

Supabase

Public support knowledge for Supabase.Knowledge Base

Tavily

Public support knowledge for Tavily.Knowledge Base

TikTok

Public support knowledge for TikTok.Knowledge Base

Tool Execution Retries

Public support knowledge for Tool Execution Retries.Knowledge Base

Tool Router Files

Public guidance for passing Tool Router session files to toolkit actions.Knowledge Base

Tool Router Sessions

Public setup guidance for creating and using Tool Router sessions.Knowledge Base

Tool Router Workbench Retention

Public support knowledge for Tool Router Workbench Retention.Knowledge Base

Trello

Public support knowledge for Trello.Knowledge Base

Triggers

Public trigger catalog and webhook delivery guidance.Knowledge Base

Twitter

Public support knowledge for Twitter.Knowledge Base

TypeScript Tool Schema Definitions

Public guidance for dangling JSON Schema references in older TypeScript SDK versions.Knowledge Base

Webflow

Public support knowledge for Webflow.Knowledge Base

WhatsApp

Public support knowledge for WhatsApp.Knowledge Base

Wrike

Public support knowledge for Wrike.Knowledge Base

Xero

Public support knowledge for Xero.Knowledge Base

YouTube

Public support knowledge for YouTube.Knowledge Base

Zendesk

Public support knowledge for Zendesk.Knowledge Base

Zoho

Public support knowledge for Zoho.Knowledge Base

Zoho Books

Public support knowledge for Zoho Books.Knowledge Base

Zoho Mail

Public support knowledge for Zoho Mail.Knowledge Base

Zoom

Public support knowledge for Zoom.Knowledge Base

Analyze a CSV and download a report

Upload sales data to a session sandbox, ask an agent to calculate totals, and download its report.Example

Build a Python research agent with MCP

Read a public Hacker News profile with CrewAI or LangChain through a Composio session’s MCP endpoint.Example

Build a Slack bot that can do work with you and your team

Build a general-purpose agent with Pi and Composio, then drop it into Slack so a whole team can use it. Triggers, per-user sessions, a shared workspace connection, redirected auth links, and raw API access.Example

Choose and run tools with TypeSafe

Use Jev to select a Hacker News tool, complete a partial call with a known username, and execute it through Composio.Example

Combine your own tools with Composio

Enrich a public Hacker News profile with an internal research note using remote and local tools in one agent.Example

Daily standup bot

A Slack bot that writes each teammate’s standup from their own connected tools. Build your own white-labelled bot, give it native Slack interactions with Composio’s proxy, and let a tool-router agent write the draft.Example

Examples

End-to-end guides that build real agents with Composio.Example

iMessage custom toolkit with eve

Walk through an agent that texts on your behalf from your own Mac. A Composio custom toolkit wraps local iMessage in-process, and the eve provider puts it on the same session as the whole Composio catalog.Example

Integrate Composio into an existing harness

You already have a planner and tool search. This wires Composio in underneath them: list toolkits, connect the ones a user picks, load raw schemas into your own index, and execute by slug. Four calls your code makes, with no agent inside your agent.Example

Restrict Gmail connections to an email domain

Check the connected Gmail address before giving an agent access, and disable connections outside your allowed domain.Example

Review pull requests in a sandbox you own

Composio usually runs your tools for you. A local sandbox is for when you need to run them yourself, on your filesystem, in your shell, inside your security boundary. Build a GitHub PR reviewer that runs checks in a sandbox you own and posts one grounded comment.Example

Run a Composio agent on Cloudflare Workers

Deploy an authenticated TypeScript endpoint that reads Hacker News with Composio and OpenAI.Example

Run an agent when an email arrives

Verify Gmail trigger webhooks, route them to the connected user, and run an agent that summarizes each event.Example

TypeScript and Python SDK examples

Find runnable Composio examples by task, with links to source code and the relevant guide.Example

Use multiple accounts in one agent

Connect work and personal Gmail accounts, label them with aliases, and make account selection explicit.Example