@composio/google

Google GenAI Provider for Composio SDK.

Features

• Google GenAI Integration: Seamless integration with Google's Generative AI models (Gemini)
• Function Calling Support: Convert Composio tools to Google GenAI function declarations
• Type Safety: Full TypeScript support with proper type definitions
• Execution Modifiers: Support for transforming tool inputs and outputs
• Flexible Authentication: Support for custom authentication parameters
• Streaming Support: First-class support for streaming responses

Installation

npm install @composio/core @composio/google @google/genai
# or
yarn add @composio/core @composio/google @google/genai
# or
pnpm add @composio/core @composio/google @google/genai

Environment Variables

Required environment variables:

• COMPOSIO_API_KEY: Your Composio API key
• GEMINI_API_KEY: Your Google AI API key

Optional environment variables:

• GOOGLE_PROJECT_ID: Your Google Cloud project ID (for custom deployments)
• GOOGLE_LOCATION: Your Google Cloud location (for custom deployments)

Quick Start

import { Composio } from '@composio/core';
import { GoogleProvider } from '@composio/google';
import { GoogleGenerativeAI } from '@google/genai';

// Initialize Google GenAI
const genAI = new GoogleGenerativeAI(process.env.GEMINI_API_KEY);

// Initialize Composio with Google provider
const composio = new Composio({
  apiKey: process.env.COMPOSIO_API_KEY,
  provider: new GoogleProvider(),
});

// Get available tools
const tools = await composio.tools.get('user123', {
  toolkits: ['gmail', 'calendar'],
  limit: 10,
});

Examples

Check out our complete example implementations:

• Basic Google Integration

API Reference

GoogleProvider Class

The GoogleProvider class extends BaseNonAgenticProvider and provides Google GenAI-specific functionality.

Methods

wrapTool(tool: Tool): GoogleTool

Wraps a Composio tool in the Google GenAI function declaration format.

const wrappedTool = provider.wrapTool(composioTool);

wrapTools(tools: Tool[]): GoogleGenAIToolCollection

Wraps multiple Composio tools in the Google GenAI function declaration format.

const wrappedTools = provider.wrapTools(composioTools);

executeToolCall(userId: string, tool: GoogleGenAIFunctionCall, options?: ExecuteToolFnOptions, modifiers?: ExecuteToolModifiers): Promise<string>

Executes a tool call from Google GenAI and returns the result as a JSON string.

const result = await provider.executeToolCall('user123', functionCall, options, modifiers);

Types

interface GoogleGenAIFunctionCall {
  name: string;
  args: Record<string, unknown>;
}

type GoogleTool = {
  name: string;
  description: string;
  parameters: Schema;
};

type GoogleGenAIToolCollection = GoogleTool[];

Contributing

We welcome contributions! Please see our Contributing Guide for more details.

License

ISC License

Support

For support, please visit our Documentation or join our Discord Community.