List available tools | Composio Docs

Retrieve a paginated list of available tools with comprehensive filtering, sorting and search capabilities. Use query parameters to narrow down results by toolkit, tags, or search terms.

Authentication

x-api-keystring

API key authentication

Query parameters

toolkit_slugstringOptional

The slug of the toolkit to filter by

tool_slugsstringOptional

Comma-separated list of specific tool slugs to retrieve (overrides other filters)

auth_config_idsstring or list of stringsOptional

Comma-separated list of auth config IDs to filter tools by

importantenumOptional

Filter to only show important/featured tools (set to “true” to enable)

Allowed values:

tagslist of stringsOptional

Filter tools by one or more tags (can be specified multiple times)

scopeslist of stringsOptional

Array of scopes to filter tools by)

searchstringOptional

Free-text search query to find tools by name, description, or functionality

include_deprecatedbooleanOptionalDefaults to true

Include deprecated tools in the response

toolkit_versionsstring or map from strings to strings or nullOptional

Toolkit version specification. Use "latest" for latest versions or bracket notation for specific versions per toolkit.

limitdoubleOptional

Number of items per page

cursorstringOptional

Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.

Response

Successfully retrieved tools list with pagination information

itemslist of objects

total_pagesdouble

current_pagedouble

total_itemsdouble

next_cursorstring or null

1	import requests
2
3	url = "https://backend.composio.dev/api/v3/tools"
4
5	querystring = {"toolkit_versions":"latest"}
6
7	headers = {"x-api-key": "<apiKey>"}
8
9	response = requests.get(url, headers=headers, params=querystring)
10
11	print(response.json())

1	{
2	"items": [
3	{
4	"slug": "github-actions",
5	"name": "GitHub Actions",
6	"description": "Automate GitHub workflows including CI/CD, issue management, and release processes",
7	"toolkit": {
8	"slug": "github",
9	"name": "GitHub",
10	"logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png"
11	},
12	"input_parameters": {},
13	"no_auth": false,
14	"available_versions": [
15	"20250905_00",
16	"20250906_00"
17	],
18	"version": "20250905_00",
19	"output_parameters": {},
20	"scopes": [
21	"https://www.googleapis.com/auth/gmail.modify"
22	],
23	"tags": [
24	"ci-cd",
25	"github",
26	"automation",
27	"devops"
28	],
29	"deprecated": {
30	"displayName": "GitHub Actions",
31	"version": "20250905_00",
32	"available_versions": [
33	"20250905_00",
34	"20250906_00"
35	],
36	"is_deprecated": false,
37	"toolkit": {
38	"logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png"
39	}
40	}
41	}
42	],
43	"total_pages": 1.1,
44	"current_page": 1.1,
45	"total_items": 1.1,
46	"next_cursor": "string"
47	}

Authentication

Query parameters

Response

Errors