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.1

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

Built distribution (wheel)

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

Total release size: 7.9 kB

Release files / composio_langchain-0.29.1.tar.gz

Download URL composio_langchain-0.29.1.tar.gz
Size 3.8 kB
Tags Source
SHA-256 checksum
How to use checksums
641384394414bf8201ff316434cb42fc3fd63cac43b27b66d85da4fdc5d03824
BLAKE2b-256 checksum
How to use checksums
82e9e3aed260537e6256b509272efe6c4acd50b9190def22f1f09111d9aa398f
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.29.1-py3-none-any.whl

Download URL composio_langchain-0.29.1-py3-none-any.whl
Size 4.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
84d12c8fee4670ed51aa8117ebfe77b7f06091789addb023f0133e46301bba59
BLAKE2b-256 checksum
How to use checksums
d540d1bb016ee903ee1ff9e36af3a608e62082d3c8aa1df5d686a0cc28054b60
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.29.1

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.29.1.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.29.1 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