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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file composio_langgraph-0.21.1.tar.gz.
File metadata
- Download URL: composio_langgraph-0.21.1.tar.gz
- Upload date:
- Size: 3.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
def3cf15d2f6aabc18757d910f25972f970320352ab738044824f16e97aeaa43
|
|
| MD5 |
2db999d94b62740b16cabc919518619c
|
|
| BLAKE2b-256 |
1c1ed77e9a9c9e75dfddc6749f550d7904d746e25209cc0ca63e4d9256b300f1
|
File details
Details for the file composio_langgraph-0.21.1-py3-none-any.whl.
File metadata
- Download URL: composio_langgraph-0.21.1-py3-none-any.whl
- Upload date:
- Size: 4.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8f65f0816565d0b264d002cebd8ecadb85eeb76ff83d48697b8885c29f393aed
|
|
| MD5 |
d21a364776bd3c1964b38bfeb29d2185
|
|
| BLAKE2b-256 |
6f88d299b052c55f87019a9d1425d4e655f04e981271d107c42bb04e3267cd69
|
