Core Concepts

Tools and toolkits

Tool Router gives your agent access to most Composio toolkits by default. For details on configuring which toolkits are available in a session, see Users and sessions.

Toolkits and tools

A toolkit is a collection of related tools for a service and a tool is an individual action your agent can execute.

ToolkitTools
githubGITHUB_CREATE_A_COMMIT, GITHUB_ACTIVITY_LIST_STARGAZERS_FOR_REPO, GITHUB_SEARCH_REPO_S, …
gmailGMAIL_SEND_EMAIL, GMAIL_FETCH_EMAILS, GMAIL_CREATE_EMAIL_DRAFT, …
linearLINEAR_CREATE_LINEAR_ISSUE, LINEAR_UPDATE_ISSUE, LINEAR_CREATE_LINEAR_LABEL, …

Available toolkits

Browse all available toolkits in the Composio platform under “All Toolkits”. Each toolkit page shows its tools (with input and output parameters) and authentication methods supported for that toolkit.

You can also list toolkits programmatically:

1# Returns top 20 toolkits by default
2toolkits = composio.toolkits.get()
3
4for toolkit in toolkits:
5    print(toolkit.name)

For details on browsing tools within toolkits and inspecting schemas, see Fetching tools and schemas.

Some toolkits require you to provide your own credentials. See Using custom auth configs.

Need a toolkit that doesn’t exist? Request it here.

Default session behavior

When you create a session, all toolkits are available:

1session = composio.create(user_id="user_123")

Your agent can search and use tools from any toolkit. To restrict or configure which toolkits are available, see Users and sessions.

Triggers can be used alongside Tool Router to respond to events in connected apps. See Using triggers for setup instructions.