composio
Author: ComposioHQ
Description: Composio equips AI agents & LLMs with 100+ ready-made integrations via function calling (official TypeScript & Python SDKs + Rube MCP server).
Stars: 26.6k
Forks: 4.4k
License: MIT License
Category: Enterprise
Overview
Installation
export COMPOSIO_API_KEY="<your-secret-key>"npm install @composio/corepip install composioimport { Composio } from '@composio/core';
const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY });from composio import Composio
import os
sdk = Composio(api_key=os.getenv("COMPOSIO_API_KEY"))composio integrations:add slack --scopes channels:read,chat:writeconst result = await sdk.call("slack.send_message", {
channel: "C123",
text: "Hello from Composio"
});git clone https://github.com/ComposioHQ/composio.git && cd composio
npm install
npm run build && npm run start{
"mcpServers": {
"composio": {
"command": "npx",
"args": ["-y", "@composio/mcp"],
"env": {
"COMPOSIO_API_KEY": "<your-secret-key>"
}
}
}
}tools.get
Fetch the Composio tools available for a given user, optionally filtered by specified toolkits.
api:pull
Pull the latest OpenAPI specification from the backend and update the local API documentation files.
FAQs
How do I install Composio MCP server in Claude Desktop?
To install Composio in Claude Desktop, first obtain your API key from the Composio dashboard at composio.dev, then add the configuration to Claude Desktop's MCP settings file (located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS). Add an entry under "mcpServers" with your COMPOSIO_API_KEY as an environment variable. You can use either the official Rube MCP server or self-host the Composio MCP server by cloning the repository and running npm install && npm run build && npm run start.
Does Composio work with Cursor?
Yes, Composio's Rube MCP server works with Cursor and any other MCP-compatible AI client. The Rube MCP server connects AI tools to 500+ apps, including Gmail, Slack, GitHub, and Notion. Once you install and authenticate Rube in Cursor, you can switch between Cursor, Claude Desktop, VS Code, and other MCP clients while your integrations follow you across all platforms.
What are the requirements for Composio MCP server?
Composio requires a Composio API key obtained from the dashboard at composio.dev. For self-hosting, you need Node.js with npm/yarn/pnpm installed, plus optional dependencies like PostgreSQL (DATABASE_URL) and Redis (REDIS_URL) for advanced features like job queues and SSE streaming. The TypeScript SDK requires Node.js, while the Python SDK requires Python 3.10 or higher.
Is Composio free to use?
Composio is open source under the MIT License, allowing free use of the SDK and self-hosted MCP server. The cloud-hosted API service has a free tier with rate limits of 60 requests per minute per API key. You can upgrade to higher tiers in the Composio dashboard for increased quota and additional features, or self-host the entire stack for unlimited usage.
What tools does Composio provide?
Composio provides 100+ ready-made integrations via function calling, including popular apps like Slack, Discord, Notion, GitHub, Gmail, HackerNews, and many more. These integrations are exposed as typed function calls compatible with OpenAI, Anthropic, LangChain, LlamaIndex, and other AI frameworks. You can fetch available tools using the tools.get method and filter by specific toolkits like HACKERNEWS, SLACK, or GITHUB.
How do I authenticate apps with Composio integrations?
Composio uses OAuth flows to authenticate third-party apps. Run composio integrations:add <app-name> --scopes <required-scopes> to initiate the OAuth process, then follow the printed authorization link to complete authentication. OAuth tokens are stored server-side by Composio and automatically injected when you invoke tools, so you only need to authenticate once per integration.
Can I use Composio with OpenAI Agents and Anthropic Claude?
Yes, Composio has official provider packages for both OpenAI Agents and Anthropic Claude. For TypeScript, install @composio/openai-agents or @composio/anthropic; for Python, install composio-openai-agents or composio-anthropic. The SDK provides streaming function-calling support compliant with both OpenAI and Anthropic APIs, allowing you to pass Composio tools directly to agents using the OpenAIAgentsProvider or AnthropicProvider classes.
What is the difference between Composio SDK and Rube MCP server?
The Composio SDK (available in TypeScript and Python) is a development library for programmatically building AI agents with 100+ integrations via function calling. Rube is a pre-built Model Context Protocol (MCP) server that uses Composio under the hood, designed for end users to connect AI clients like Claude Desktop, Cursor, or VS Code directly to 500+ apps without writing code. Rube is ideal for quick setup, while the SDK is better for custom agent development.