composio-langgraph
Adapts Composio tools to LangChain's StructuredTool format for use in LangGraph agents and graph workflows, giving them access to 1000+ apps through a single Composio session.
Installation
pip install composio composio-langgraph langgraph 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 your agent. The wrapped tools also work anywhere LangGraph accepts LangChain tools, such as a ToolNode in a custom graph.
from composio import Composio
from composio_langgraph import LanggraphProvider
from langchain.agents import create_agent
from langchain_openai import ChatOpenAI
composio = Composio(provider=LanggraphProvider())
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
- LangChain provider docs (covers LangGraph)
- Composio documentation
Metadata
Release files for composio-langgraph 0.25.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| composio_langgraph-0.25.0.tar.gz | 3.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| composio_langgraph-0.25.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 8.0 kB
Release files / composio_langgraph-0.25.0.tar.gz
| Download URL | composio_langgraph-0.25.0.tar.gz |
|---|---|
| Size | 3.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
02fea6e55d94d74280f446f7ce5dd9b8f723de5c3a4778fd27b0cc61e28cef45
|
|
BLAKE2b-256 checksum How to use checksums |
080ff01554969b24ead1e377384a754b2ba6aebd53111e477a2b691b8db23974
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / composio_langgraph-0.25.0-py3-none-any.whl
| Download URL | composio_langgraph-0.25.0-py3-none-any.whl |
|---|---|
| Size | 4.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0dc6f28ed27c02e41665dcdbe0d929a15b5bbd1243119702e1cb30a1700fe77d
|
|
BLAKE2b-256 checksum How to use checksums |
1c40185ff6c9fa758ec046d8841c2c82d534c25c8a27fa6d79984b0c4919c54f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
