composio-langchain

What it is and what it does

composio-langchain is a thin adapter that translates Composio's tool definitions into LangChain's StructuredTool format, enabling LangChain agents to call external services. It sits between a LangChain agent and Composio's session layer: you create a Composio session scoped to a user, fetch its tools, and pass them to LangChain's agent factory. The agent then orchestrates tool calls, and each tool execution routes back through Composio to the target app.

The package handles argument validation by building each tool's schema from Composio's input spec; when validation fails, tools return a structured result object rather than raising an exception, so your agent can inspect the `successful` flag and `error` field instead of catching exceptions. This design keeps the agent loop clean and lets LangChain's reasoning layer decide how to recover.

Use it for:

• Build an AI assistant that sends emails, creates calendar events, or manages documents by routing LangChain agent calls through Composio integrations.
• Automate multi-step workflows where an LLM decides which external app to call next (e.g., fetch data from one service, transform it, then post to another).
• Create a user-scoped agent where each user's Composio session isolates their credentials and API quotas while sharing the same LangChain agent logic.
• Prototype AI agents quickly by leveraging Composio's pre-built app connectors instead of writing custom tool wrappers for each service.

Worth the install?

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

Bridges Composio's 1000+ app integrations into LangChain agents by wrapping them as StructuredTools, letting an LLM-powered agent call external services through a single Composio session.

Yes. The package is actively maintained, has low install friction, carries a permissive license, and solves a real integration problem for LangChain users who want to reach many external services without writing custom tool adapters. No known vulnerabilities. Install it when you need your LangChain agent to call external apps through Composio.

Install

composio-langchain on PyPI

pip install composio-langchain

uv add composio-langchain

poetry add composio-langchain

Installing composio-langchain

Before you install

Low friction: pure Python wheel with only two runtime dependencies (langchain and composio). Actively maintained with a recent release and strong repository signals (29690 stars, last commit 2026-08-14).

License in practice

Apache 2.0 permissive license allows commercial use, modification, and distribution with minimal restrictions—suitable for most production and proprietary projects.

Quickstart

pip install composio composio-langchain langchain

from composio import Composio
from composio_langchain import LangchainProvider
from langchain.agents import create_agent

composio = Composio(provider=LangchainProvider())
session = composio.create(user_id="user_123")
tools = session.tools()
agent = create_agent(tools=tools, model=llm)
result = agent.invoke({"messages": [("user", "Send an email...")]})

Requires COMPOSIO_API_KEY and OPENAI_API_KEY environment variables; Python 3.10 or later.

Verify before relying

• Whether the 1000+ apps claim is current and how frequently the app catalog is updated.
• Performance characteristics and latency when routing through Composio for high-volume tool calls.
• Error recovery behavior beyond the documented structured result format.

Package facts

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

Tags

More Application Frameworks packages

Further reading