Skip to main content
The CrewAI provider turns Composio tools into CrewAI BaseTool objects that execute themselves. You connect an account, fetch the tools, pass them to an Agent, and CrewAI runs the task end to end. To connect through CrewAI’s mcps field, follow the Python MCP research agent example. It uses a hosted session endpoint with MCPServerHTTP.
1

Install

Install
2

Configure API Keys

Configure API Keys
Set COMPOSIO_API_KEY with your API key from Settings and OPENAI_API_KEY with your OpenAI API key.
.env
3

Create session and run

Create session and run

Provider specifics

Each Composio tool becomes a CrewAI BaseTool whose args_schema is built from the tool’s input schema, so CrewAI validates arguments before running anything. Object arguments that declare no properties accept and preserve arbitrary nested keys. For objects that declare named properties, undeclared keys are rejected unless the schema allows them with additionalProperties. Schemas that use patternProperties or schema-valued additionalProperties also validate dynamic keys before execution. The provider preserves whether an optional argument was omitted or explicitly set to None. By default, declared defaults are included, while optional arguments without defaults stay absent. Set schema_config={"skip_defaults": True} when creating the provider to leave declared defaults absent too. When validation fails, the tool does not raise. It returns a structured result instead:
Check successful in your task output rather than wrapping calls in try/except.

Next

What is a session?