---
id: composio-openai-agents
version: "0.19.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# composio-openai-agents — Use Composio to get array of strongly typed tools for OpenAI Agents

License: permissive · Maintenance: active · Downloads: 275.5K/mo

## 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 above — 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

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

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 275.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

openai agents tool integration, composio openai agents adapter, ai agent app automation, multi-app agent actions, openai agents composio tools, agent-framework, app-integration, automation

[View on SkillFed](https://skillfed.io/packages/composio-openai-agents) · [View on PyPI](https://pypi.org/project/composio-openai-agents/)