Environment Variables

The Composio CLI supports configuration via environment variables for flexible deployment across different environments.

Configuration Overview

The CLI uses a two-tier configuration system:

Environment variables - Runtime configuration (highest precedence)
User config file - Persistent storage (~/.composio/user-config.json)

Environment variables always override values in the user config file.

Core Configuration

COMPOSIO_API_KEY

string

Your Composio backend API key (starts with uak_ for user API keys or ak_ for account keys).User config key: api_keyDefault: None

Example:

export COMPOSIO_API_KEY="uak_b813ydmoEYdB_xBxGHeW"
composio generate

When set, this overrides the API key stored from composio login.

COMPOSIO_BASE_URL

string

default:"https://backend.composio.dev"

The base URL of the Composio backend API.User config key: base_url

Example:

export COMPOSIO_BASE_URL="https://api-staging.composio.dev"
composio login

Useful for:

Testing against staging environments
Using a self-hosted Composio instance
Development/debugging

COMPOSIO_WEB_URL

string

default:"https://platform.composio.dev"

The base URL of the Composio web app (used during login flow).User config key: web_url

Example:

export COMPOSIO_WEB_URL="https://app-staging.composio.dev"
composio login

COMPOSIO_CACHE_DIR

string

default:"~/.composio"

Directory where the CLI stores cache files and user configuration.

Example:

export COMPOSIO_CACHE_DIR="/tmp/composio-cache"
composio generate

Cached files include:

user-config.json - User authentication and settings
toolkits.json - Toolkit metadata
tools.json - Tool definitions
tools-as-enums.json - Tool name enums
trigger-types.json - Trigger type definitions

COMPOSIO_LOG_LEVEL

string

Log verbosity level for the CLI.Accepted values: all, trace, debug, info, warning, error, fatal, noneDefault: None (minimal output)

Example:

export COMPOSIO_LOG_LEVEL="debug"
composio generate

Or use the global flag:

composio --log-level debug generate

The --log-level flag takes precedence over the environment variable.

Cache Control

FORCE_USE_CACHE

boolean

Force the CLI to use cached API responses when available.Default: false

Example:

export FORCE_USE_CACHE="true"
composio generate

When enabled:

CLI checks cache first before making API calls
Works offline if cache is available
Useful for CI/CD with pre-warmed cache

Use cases:

# Warm the cache
composio generate

# Use cached data (works offline)
FORCE_USE_CACHE=true composio generate

Toolkit Version Overrides

COMPOSIO_TOOLKIT_VERSION_<TOOLKIT>

string

Override the version for a specific toolkit.Format: COMPOSIO_TOOLKIT_VERSION_<TOOLKIT_SLUG>=<version>Values:

Specific version (e.g., 20250901_00)
latest (use the latest available version)
Unset (defaults to latest)

Example:

export COMPOSIO_TOOLKIT_VERSION_GMAIL=20250901_00
export COMPOSIO_TOOLKIT_VERSION_GITHUB=20241215_00
export COMPOSIO_TOOLKIT_VERSION_SLACK=latest
composio generate --type-tools

Toolkit version overrides only apply when using --type-tools with composio generate or composio ts generate.

See Toolkit Versions for more details.

GitHub Integration (Upgrade)

COMPOSIO_GITHUB_API_BASE_URL

string

default:"https://api.github.com"

GitHub API base URL for fetching releases.

Example:

export COMPOSIO_GITHUB_API_BASE_URL="https://github.company.com/api/v3"
composio upgrade

Useful for GitHub Enterprise instances.

COMPOSIO_GITHUB_OWNER

string

default:"ComposioHQ"

GitHub repository owner.

COMPOSIO_GITHUB_REPO

string

default:"composio"

GitHub repository name.

COMPOSIO_GITHUB_TAG

string

default:"latest"

Specific release tag to upgrade to.

Example:

export COMPOSIO_GITHUB_TAG="@composio/[email protected]"
composio upgrade

Downloads version 0.1.24 instead of the latest.

COMPOSIO_GITHUB_ACCESS_TOKEN

string

GitHub access token for API requests (avoids rate limiting).

Example:

export COMPOSIO_GITHUB_ACCESS_TOKEN="ghp_your_token"
composio upgrade

Useful during development to avoid GitHub’s rate limits (60 requests/hour for unauthenticated users).

Terminal Configuration

NO_COLOR

boolean

Disable colored output in the CLI.Standard: no-color.org

Example:

export NO_COLOR=1
composio generate

Outputs plain text without ANSI color codes (useful for logging systems).

Development/Debugging

DEBUG_OVERRIDE_VERSION

string

Override the CLI version for debugging upgrade behavior.Development use only.

Example:

export DEBUG_OVERRIDE_VERSION="0.1.0"
composio upgrade

Forces the CLI to think it’s running version 0.1.0, triggering an upgrade.

User Config File

The CLI stores persistent configuration in ~/.composio/user-config.json:

{
  "api_key": "uak_b813ydmoEYdB_xBxGHeW",
  "base_url": "https://backend.composio.dev",
  "web_url": "https://platform.composio.dev",
  "org_id": "k2OiqRLMdHyM",
  "project_id": "pr_xlSR6oN5jIlk",
  "test_user_id": "pg-test-12345"
}

This file is created and updated by:

composio login - Stores API key and org/project IDs
composio logout - Clears API key
composio orgs switch - Updates default org/project

The user-config.json file contains your API key. Keep it secure and never commit it to version control.

Configuration Precedence

When the same setting is defined in multiple places:

CLI flags (highest precedence)
Environment variables
User config file (~/.composio/user-config.json)
Default values (lowest precedence)

Example:

# Config file: base_url = "https://backend.composio.dev"
export COMPOSIO_BASE_URL="https://api-staging.composio.dev"

# Environment variable wins
composio generate
# Uses: https://api-staging.composio.dev

Examples

CI/CD Configuration

#!/bin/bash
# .github/workflows/generate-types.yml

export COMPOSIO_API_KEY="${{ secrets.COMPOSIO_API_KEY }}"
export COMPOSIO_LOG_LEVEL="info"
export FORCE_USE_CACHE="true"

composio generate --toolkits github --toolkits gmail

Staging Environment

# .env.staging
export COMPOSIO_BASE_URL="https://api-staging.composio.dev"
export COMPOSIO_WEB_URL="https://app-staging.composio.dev"
export COMPOSIO_LOG_LEVEL="debug"

source .env.staging
composio login

Offline Development

# Warm the cache
composio generate

# Work offline
export FORCE_USE_CACHE="true"
export COMPOSIO_LOG_LEVEL="debug"
composio generate --toolkits slack

Custom Cache Location

# Use project-local cache
export COMPOSIO_CACHE_DIR="./.composio-cache"
composio generate

# Add to .gitignore
echo ".composio-cache/" >> .gitignore

Toolkit Versions

Pin toolkit versions

Login

Authentication guide

Getting Started

Commands

Configuration

Environment Variables

Configuration Overview

Core Configuration

COMPOSIO_API_KEY

COMPOSIO_BASE_URL

COMPOSIO_WEB_URL

COMPOSIO_CACHE_DIR

COMPOSIO_LOG_LEVEL

Cache Control

FORCE_USE_CACHE

Toolkit Version Overrides

COMPOSIO_TOOLKIT_VERSION_<TOOLKIT>

GitHub Integration (Upgrade)

COMPOSIO_GITHUB_API_BASE_URL

COMPOSIO_GITHUB_OWNER

COMPOSIO_GITHUB_REPO

COMPOSIO_GITHUB_TAG

COMPOSIO_GITHUB_ACCESS_TOKEN

Terminal Configuration

NO_COLOR

Development/Debugging

DEBUG_OVERRIDE_VERSION

User Config File

Configuration Precedence

Examples

CI/CD Configuration

Staging Environment

Offline Development

Custom Cache Location

Toolkit Versions

Login

Build docs developers (and LLMs) love

Getting Started

Commands

Configuration

​Configuration Overview

​Core Configuration

​COMPOSIO_API_KEY

​COMPOSIO_BASE_URL

​COMPOSIO_WEB_URL

​COMPOSIO_CACHE_DIR

​COMPOSIO_LOG_LEVEL

​Cache Control

​FORCE_USE_CACHE

​Toolkit Version Overrides

​COMPOSIO_TOOLKIT_VERSION_<TOOLKIT>

​GitHub Integration (Upgrade)

​COMPOSIO_GITHUB_API_BASE_URL

​COMPOSIO_GITHUB_OWNER

​COMPOSIO_GITHUB_REPO

​COMPOSIO_GITHUB_TAG

​COMPOSIO_GITHUB_ACCESS_TOKEN

​Terminal Configuration

​NO_COLOR

​Development/Debugging

​DEBUG_OVERRIDE_VERSION

​User Config File

​Configuration Precedence

​Examples

​CI/CD Configuration

​Staging Environment

​Offline Development

​Custom Cache Location

​Related Pages

Toolkit Versions

Login

Build docs developers (and LLMs) love

Configuration Overview

Core Configuration

COMPOSIO_API_KEY

COMPOSIO_BASE_URL

COMPOSIO_WEB_URL

COMPOSIO_CACHE_DIR

COMPOSIO_LOG_LEVEL

Cache Control

FORCE_USE_CACHE

Toolkit Version Overrides

COMPOSIO_TOOLKIT_VERSION_<TOOLKIT>

GitHub Integration (Upgrade)

COMPOSIO_GITHUB_API_BASE_URL

COMPOSIO_GITHUB_OWNER

COMPOSIO_GITHUB_REPO

COMPOSIO_GITHUB_TAG

COMPOSIO_GITHUB_ACCESS_TOKEN

Terminal Configuration

NO_COLOR

Development/Debugging

DEBUG_OVERRIDE_VERSION

User Config File

Configuration Precedence

Examples

CI/CD Configuration

Staging Environment

Offline Development

Custom Cache Location

Related Pages