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.

Links

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

composio_langchain-0.18.2.tar.gz (3.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

composio_langchain-0.18.2-py3-none-any.whl (3.9 kB view details)

Uploaded Python 3

File details

Details for the file composio_langchain-0.18.2.tar.gz.

File metadata

  • Download URL: composio_langchain-0.18.2.tar.gz
  • Upload date:
  • Size: 3.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for composio_langchain-0.18.2.tar.gz
Algorithm Hash digest
SHA256 c5b1623f2718a13929ab10bf7ca71ce583d1f79302dbe391f4889445843fbf4f
MD5 6a3ddd56b6803e84ffa0289be5df4dd2
BLAKE2b-256 7ce9634772bcd054435d6c731c507b733e9d2c0868f4b6500646d3fa0c6cfee4

See more details on using hashes here.

File details

Details for the file composio_langchain-0.18.2-py3-none-any.whl.

File metadata

File hashes

Hashes for composio_langchain-0.18.2-py3-none-any.whl
Algorithm Hash digest
SHA256 80e196239e86a3f865feed084c5418c6a49b14174818aa279fe450d690e488e3
MD5 d1fc51106c6e076c943a1f2b2e1c1e54
BLAKE2b-256 a351d1b215876c397cc7266b8dc0574336612650f87bdb9bf027f0ffb4b0c88b

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page