composio-openai-agents

What it is and what it does

composio-openai-agents is an adapter that translates Composio's tool definitions into the native format expected by OpenAI's Agents framework. It sits between your agent and Composio's catalog of pre-built integrations, handling the conversion so agents can call external app actions without custom tool wrapping.

The package is designed for multi-turn agent workflows where you need to take real actions—sending emails, updating spreadsheets, querying databases—across many different services. You create a session scoped to a user, fetch the available tools, and pass them to your agent. Sessions include built-in meta-tools for discovery and authentication, and can be reused across multiple agent runs by storing and retrieving the session ID.

Use it for:

• Build a personal assistant agent that reads emails, creates calendar events, and updates task lists across Gmail, Outlook, and Todoist.
• Create a customer support agent that queries CRM data, opens tickets, and sends notifications through Slack and email.
• Develop a data-sync agent that pulls information from one app (e.g., Salesforce) and pushes it to another (e.g., HubSpot).
• Build workflow automation where an agent decides which external actions to take based on user input and context.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Bridges Composio's tool catalog to OpenAI's Agents framework, letting agents execute actions across 1000+ integrated apps through a unified interface.

Yes—if you are building OpenAI Agents and need access to external app integrations. The package has low install friction, active maintenance, permissive licensing, and no known vulnerabilities. The only prerequisite is having both Composio and OpenAI API credentials configured. Suitable for production use.

Install

composio-openai-agents on PyPI

pip install composio-openai-agents

uv add composio-openai-agents

poetry add composio-openai-agents

Installing composio-openai-agents

Before you install

Low friction: pure Python wheel with only two runtime dependencies (openai-agents and composio). Active maintenance—last commit 2026-08-14, released 3 days ago, 29690 repository stars.

License in practice

Apache 2.0 permissive license allows commercial and private use with minimal restrictions, making it suitable for production agent deployments.

Quickstart

pip install composio composio-openai-agents openai-agents

from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
from agents import Agent, Runner

composio = Composio(provider=OpenAIAgentsProvider())
session = composio.create(user_id="user_123")
tools = session.tools()
agent = Agent(name="Assistant", instructions="Use tools to help.", tools=tools)
result = Runner.run_sync(starting_agent=agent, input="Summarize my emails")

Requires COMPOSIO_API_KEY and OPENAI_API_KEY environment variables to be set before use.

Verify before relying

• Specific count of integrated apps (description says '1000+' but no official inventory provided)
• Performance characteristics and latency of tool discovery and execution at runtime
• Session persistence and multi-turn conversation state management beyond the session_id reuse pattern shown

Package facts

Evidence: composio_openai_agents-0.19.0-py3-none-any.whl

Tags

More Artificial Intelligence packages

Further reading