Skip to main content

composio-langchain

Adapts Composio tools to LangChain's StructuredTool format so a LangChain agent can call 1000+ apps through a single Composio session.

Installation

pip install composio composio-langchain langchain langchain-openai

Set COMPOSIO_API_KEY (get one from dashboard.composio.dev/settings) and OPENAI_API_KEY in your environment:

export COMPOSIO_API_KEY=xxxxxxxxx
export OPENAI_API_KEY=xxxxxxxxx

Quickstart

Create a session for your user, fetch its tools, and hand them to create_agent. LangChain runs the tool loop; each tool executes itself through Composio.

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

composio = Composio(provider=LangchainProvider())
llm = ChatOpenAI(model="gpt-5.2")

# Each session is scoped to one of your users
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 to john@example.com with the subject 'Hello' and body 'Hello from Composio!'",
            )
        ]
    }
)

print(result["messages"][-1].content)

Error handling

Each wrapped tool builds its args_schema from the Composio tool's input schema. When argument validation fails, the tool does not raise; it returns a structured result:

{"successful": False, "error": "<validation message>", "data": None}

Check successful in tool output instead of wrapping calls in try/except.

Metadata

Release files for composio-langchain 0.29.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for composio-langchain 0.29.0
File Size Uploaded Provenance
composio_langchain-0.29.0.tar.gz 3.8 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for composio-langchain 0.29.0
File Interpreter ABI Platform
composio_langchain-0.29.0-py3-none-any.whl Python 3 none any Details

Total release size: 7.9 kB

Release files / composio_langchain-0.29.0.tar.gz

Download URL composio_langchain-0.29.0.tar.gz
Size 3.8 kB
Tags Source
SHA-256 checksum
How to use checksums
dfceef28538fd43cb86822f283dc4068a810bd7ed9d388041916fd574b1f5065
BLAKE2b-256 checksum
How to use checksums
666aae85d753436483e2dc91d7713dbc300d2e8e67a95c1778944728f226a91b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / composio_langchain-0.29.0-py3-none-any.whl

Download URL composio_langchain-0.29.0-py3-none-any.whl
Size 4.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9c2cc5136e8d6c7d32118f3f40a1c0f8ce9157ac2e248b82a0fc80fe51991ea4
BLAKE2b-256 checksum
How to use checksums
ed2c977420009596f3e8754467e4a85afc94f7dd8902cab7937753c6e0b91d6f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for composio-langchain 0.29.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

0.29.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page