Custom Tools and Toolkits (Experimental)
You can now create custom tools and toolkits that run locally alongside remote Composio tools within a session.SDK Version
What’s New
Custom tools support three patterns — standalone tools for internal logic, extension tools that wrap Composio toolkit APIs with business logic, and custom toolkits that group related tools. TypeScript uses builder functions with Zod schemas; Python uses decorators with Pydantic annotations.- TypeScript
- Python
SessionContext
Every custom tool’sexecute receives (input, ctx):
- TypeScript —
ctx.userId,ctx.proxyExecute(params),ctx.execute(toolSlug, args) - Python —
ctx.user_id,ctx.proxy_execute(...),ctx.execute(tool_slug, arguments)
Limitations
- Native tools only — custom tools work with
session.tools(). MCP support is coming soon. - Experimental API — the custom tool APIs and session
experimentaloption may change. - SDK-specific DX is intentional — TypeScript uses builder helpers and Zod. Python uses decorators, docstrings, and Pydantic annotations.