List available tools

1 from composio_client import Composio 2 3 client = Composio( 4 api_key="My API Key", 5 ) 6 tools = client.tools.list() 7 print(tools.current_page)

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 "repo_name": { 14 "type": "string", 15 "description": "GitHub repository name in owner/repo format", 16 "required": true, 17 "example": "octocat/Hello-World" 18 }, 19 "workflow_id": { 20 "type": "string", 21 "description": "ID or filename of the workflow to trigger", 22 "required": true, 23 "example": "main.yml" 24 } 25 }, 26 "no_auth": false, 27 "available_versions": [ 28 "0_1", 29 "latest", 30 "latest:base" 31 ], 32 "version": "latest", 33 "output_parameters": { 34 "run_id": { 35 "type": "number", 36 "description": "ID of the workflow run that was triggered", 37 "example": 12345678 38 }, 39 "status": { 40 "type": "string", 41 "description": "Status of the workflow run", 42 "example": "completed", 43 "enum": [ 44 "queued", 45 "in_progress", 46 "completed", 47 "failed" 48 ] 49 } 50 }, 51 "scopes": [ 52 "https://www.googleapis.com/auth/gmail.modify" 53 ], 54 "tags": [ 55 "ci-cd", 56 "github", 57 "automation", 58 "devops" 59 ], 60 "deprecated": { 61 "displayName": "GitHub Actions", 62 "version": "0_1", 63 "available_versions": [ 64 "0_1", 65 "latest", 66 "latest:base" 67 ], 68 "is_deprecated": false, 69 "toolkit": { 70 "logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png" 71 } 72 } 73 } 74 ], 75 "total_pages": 1.1, 76 "current_page": 1.1, 77 "total_items": 1.1, 78 "next_cursor": "next_cursor" 79 }

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.

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_idsstringOptional

importantenumOptional

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

Allowed values:

tagsstringOptional

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

scopesstringOptional

Array of scopes to filter tools by)

searchstringOptional

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

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

Headers

Query parameters

Response

Errors