Skip to main content

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.

SessionContext

Every custom tool’s execute 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 experimental option may change.
  • SDK-specific DX is intentional — TypeScript uses builder helpers and Zod. Python uses decorators, docstrings, and Pydantic annotations.