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.30.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.30.0
File Size Uploaded Provenance
composio_langchain-0.30.0.tar.gz 3.8 kB With provenance Details

Built distribution (wheel)

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

Total release size: 7.8 kB

Release files / composio_langchain-0.30.0.tar.gz

Download URL composio_langchain-0.30.0.tar.gz
Size 3.8 kB
Tags Source
SHA-256 checksum
How to use checksums
8712053f01f0bf44a4089f3fdd167107762fd75a0b94d741fee20b474ab47aae
BLAKE2b-256 checksum
How to use checksums
5a6098fd431d0803e8c1ae533ee49b172982a227459ad877d9bdfad2e139df1d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

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

Download URL composio_langchain-0.30.0-py3-none-any.whl
Size 4.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8f7c2fc789be6901d3075c7249c31ddf87a11666084b9e59c3bb790030b3958d
BLAKE2b-256 checksum
How to use checksums
41497eae4910e194f4bd8e8eb6bede0883f99831f79eb8f40d279a42fbdde207
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Security for composio-langchain 0.30.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.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for composio_langchain-0.30.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

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.30.0 This release

2 release files Full 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