TypeScript SDK Overview

​

Key Features

• 200+ Tools: Pre-built integrations with popular services
• Framework Agnostic: Works with OpenAI, Anthropic, LangChain, LlamaIndex, Vercel AI SDK, and more
• Type Safety: Full TypeScript support with autocomplete and type checking
• Authentication Management: Handle OAuth, API keys, and custom auth seamlessly
• Custom Tools: Create your own tools with custom logic
• Tool Router: Intelligent connection and tool management
• MCP Support: Model Context Protocol for standardized agent communication

​

Quick Start

npm install @composio/core

import { Composio } from '@composio/core';
import { OpenAI } from 'openai';

const composio = new Composio({ apiKey: 'your-api-key' });
const openai = new OpenAI({ apiKey: 'your-openai-key' });

// Get tools for GitHub
const tools = await composio.tools.get('default', {
  toolkits: ['github']
});

// Use with OpenAI
const response = await openai.chat.completions.create({
  model: 'gpt-4',
  messages: [{ role: 'user', content: 'Create a GitHub issue' }],
  tools
});

​

Core Concepts

​

Tools

• Input parameters with validation
• Output schema
• Authentication requirements
• Version control

​

Toolkits

• Get all tools for a service at once
• Manage authentication per service
• Filter tools by capability

​

Connected Accounts

• User credentials (OAuth tokens, API keys)
• Connection status
• Refresh tokens and expiration

​

Auth Configs

• OAuth apps (client ID, secret, scopes)
• API key requirements
• Custom authentication flows

​

Architecture

Your Application
       |
   Composio SDK
       |
   ├── Tools      (List, execute, create custom tools)
   ├── Toolkits   (Manage toolkit metadata)
   ├── Provider   (OpenAI, Anthropic, etc.)
   ├── Connected  (User authentication)
   |   Accounts
   └── Triggers   (Webhook events)
       |
  Composio API
       |
  External Services (GitHub, Gmail, etc.)

​

Next Steps