@composio/claude-code-agents 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sampark Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,145 @@
+# @composio/claude-code-agents
+
+Composio provider for the [Claude Agent SDK](https://platform.claude.com/docs/en/agent-sdk/overview) (`@anthropic-ai/claude-agent-sdk`).
+
+This provider enables seamless integration of Composio tools with Claude Code Agents, allowing you to use any Composio-supported tool (Gmail, Slack, GitHub, etc.) within your Claude agents.
+
+## Installation
+
+```bash
+npm install @composio/claude-code-agents @composio/core @anthropic-ai/claude-agent-sdk
+```
+
+### Prerequisites
+
+1. **Claude Code CLI**: The Claude Agent SDK requires Claude Code to be installed:
+
+   ```bash
+   # macOS/Linux/WSL
+   curl -fsSL https://claude.ai/install.sh | bash
+
+   # or via Homebrew
+   brew install --cask claude-code
+
+   # or via npm
+   npm install -g @anthropic-ai/claude-code
+   ```
+
+2. **API Keys**:
+   - `ANTHROPIC_API_KEY`: Your Anthropic API key from [console.anthropic.com](https://console.anthropic.com)
+   - `COMPOSIO_API_KEY`: Your Composio API key from [app.composio.dev](https://app.composio.dev)
+
+## Usage
+
+```typescript
+import { Composio } from '@composio/core';
+import { ClaudeCodeAgentsProvider } from '@composio/claude-code-agents';
+import { query } from '@anthropic-ai/claude-agent-sdk';
+
+// Initialize Composio with the Claude Code Agents provider
+const composio = new Composio({
+  apiKey: process.env.COMPOSIO_API_KEY,
+  provider: new ClaudeCodeAgentsProvider(),
+});
+
+async function main() {
+  // Get Composio tools (e.g., Gmail tools)
+  const tools = await composio.tools.get('default', 'GMAIL_SEND_EMAIL');
+
+  // Create an MCP server configuration with the tools
+  const mcpServer = composio.provider.createMcpServer(tools, composio.tools.execute);
+
+  // Run a Claude agent with access to Composio tools
+  for await (const message of query({
+    prompt: 'Send an email to john@example.com saying hello',
+    options: {
+      mcpServers: { composio: mcpServer },
+      permissionMode: 'bypassPermissions',
+      allowDangerouslySkipPermissions: true,
+    },
+  })) {
+    if (message.type === 'assistant') {
+      console.log('Claude:', message.content);
+    }
+  }
+}
+
+main();
+```
+
+## API Reference
+
+### `ClaudeCodeAgentsProvider`
+
+The main provider class for integrating Composio tools with Claude Code Agents.
+
+#### Constructor Options
+
+```typescript
+interface ClaudeCodeAgentsProviderOptions {
+  serverName?: string; // Name for the MCP server (default: 'composio')
+  serverVersion?: string; // Version for the MCP server (default: '1.0.0')
+}
+```
+
+#### Methods
+
+##### `createMcpServer(tools, executeTool)`
+
+Creates an MCP server configuration for use with Claude Agent SDK's `query()` function.
+
+```typescript
+const mcpServer = provider.createMcpServer(tools, composio.tools.execute);
+```
+
+##### `wrapTool(tool, executeTool)`
+
+Wraps a single Composio tool as a Claude Agent SDK MCP tool.
+
+##### `wrapTools(tools, executeTool)`
+
+Wraps multiple Composio tools as Claude Agent SDK MCP tools.
+
+## How It Works
+
+The Claude Agent SDK uses MCP (Model Context Protocol) servers to provide tools to Claude agents. This provider:
+
+1. Converts Composio tool definitions to MCP tool format
+2. Creates an in-process MCP server using `createSdkMcpServer()`
+3. Handles tool execution by routing calls through Composio's execution layer
+
+## Examples
+
+### Using Multiple Tools
+
+```typescript
+const tools = await composio.tools.get('default', [
+  'GMAIL_SEND_EMAIL',
+  'GMAIL_LIST_EMAILS',
+  'SLACK_POST_MESSAGE',
+]);
+
+const mcpServer = composio.provider.createMcpServer(tools, composio.tools.execute);
+
+for await (const message of query({
+  prompt: 'Check my latest emails and post a summary to #general on Slack',
+  options: {
+    mcpServers: { composio: mcpServer },
+  },
+})) {
+  console.log(message);
+}
+```
+
+### Custom Server Name
+
+```typescript
+const provider = new ClaudeCodeAgentsProvider({
+  serverName: 'my-composio-tools',
+  serverVersion: '2.0.0',
+});
+```
+
+## License
+
+ISC

package/dist/index.cjs

@@ -0,0 +1,124 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ClaudeCodeAgentsProvider: () => ClaudeCodeAgentsProvider
+});
+module.exports = __toCommonJS(index_exports);
+var import_core = require("@composio/core");
+var import_claude_agent_sdk = require("@anthropic-ai/claude-agent-sdk");
+var import_json_schema_to_zod = require("@composio/json-schema-to-zod");
+var ClaudeCodeAgentsProvider = class extends import_core.BaseAgenticProvider {
+  name = "claude-code-agents";
+  /**
+   * Wraps a Composio tool as a Claude Agent SDK MCP tool.
+   *
+   * @param composioTool - The Composio tool to wrap
+   * @param executeTool - Function to execute the tool
+   * @returns A Claude Agent SDK MCP tool definition
+   *
+   * @example
+   * ```typescript
+   * const composioTool = {
+   *   slug: 'GMAIL_SEND_EMAIL',
+   *   description: 'Send an email via Gmail',
+   *   inputParameters: {
+   *     type: 'object',
+   *     properties: {
+   *       to: { type: 'string', description: 'Recipient email' },
+   *       subject: { type: 'string', description: 'Email subject' },
+   *       body: { type: 'string', description: 'Email body' },
+   *     },
+   *     required: ['to', 'subject', 'body'],
+   *   },
+   * };
+   *
+   * const mcpTool = provider.wrapTool(composioTool, executeFn);
+   * ```
+   */
+  wrapTool(composioTool, executeTool) {
+    const inputParams = composioTool.inputParameters ?? {};
+    const zodShape = (0, import_json_schema_to_zod.jsonSchemaToZodShape)(inputParams);
+    return (0, import_claude_agent_sdk.tool)(
+      composioTool.slug,
+      composioTool.description ?? `Execute ${composioTool.slug}`,
+      zodShape,
+      async (args) => {
+        try {
+          const result = await executeTool(composioTool.slug, args);
+          return {
+            content: [
+              {
+                type: "text",
+                text: typeof result === "string" ? result : JSON.stringify(result) ?? ""
+              }
+            ]
+          };
+        } catch (error) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify({
+                  successful: false,
+                  error: error instanceof Error ? error.message : String(error),
+                  data: null
+                })
+              }
+            ]
+          };
+        }
+      }
+    );
+  }
+  /**
+   * Wraps multiple Composio tools as Claude Agent SDK MCP tools.
+   *
+   * @param tools - Array of Composio tools to wrap
+   * @param executeTool - Function to execute the tools
+   * @returns Array of Claude Agent SDK MCP tool definitions
+   *
+   * @example
+   * ```typescript
+   * const tools = await composio.tools.get('default', ['GMAIL_SEND_EMAIL', 'SLACK_POST_MESSAGE']);
+   * const mcpTools = provider.wrapTools(tools, composio.tools.execute);
+   * ```
+   */
+  wrapTools(tools, executeTool) {
+    return tools.map((tool) => this.wrapTool(tool, executeTool));
+  }
+  /**
+   * Transform MCP URL response into standard format.
+   *
+   * @param data - The MCP URL response data
+   * @returns Standard MCP server response format
+   */
+  wrapMcpServerResponse(data) {
+    return data.map((item) => ({
+      url: new URL(item.url),
+      name: item.name
+    }));
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ClaudeCodeAgentsProvider
+});

package/dist/index.d.cts

@@ -0,0 +1,112 @@
+import { BaseAgenticProvider, McpServerGetResponse, Tool, ExecuteToolFn, McpUrlResponse } from '@composio/core';
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+export { Options as ClaudeAgentOptions } from '@anthropic-ai/claude-agent-sdk';
+
+/**
+ * Claude Code Agents Provider
+ * To be used with the Claude Agent SDK (@anthropic-ai/claude-agent-sdk)
+ *
+ * This provider enables integration with Claude Code Agents SDK,
+ * allowing Composio tools to be used as MCP tools within Claude agents.
+ *
+ * @packageDocumentation
+ * @module providers/claude-code-agents
+ */
+
+/**
+ * Type for a single Claude Agent SDK MCP tool definition
+ */
+type ClaudeAgentTool = ReturnType<typeof tool>;
+/**
+ * Type for a collection of Claude Agent SDK MCP tools
+ */
+type ClaudeAgentToolCollection = ClaudeAgentTool[];
+/**
+ * Provider for integrating Composio tools with Claude Code Agents SDK.
+ *
+ * This provider wraps Composio tools as MCP tools that can be used with
+ * the Claude Agent SDK's `query()` function via the `mcpServers` option.
+ *
+ * @example
+ * ```typescript
+ * import { Composio } from '@composio/core';
+ * import { ClaudeCodeAgentsProvider } from '@composio/claude-code-agents';
+ * import { query, createSdkMcpServer } from '@anthropic-ai/claude-agent-sdk';
+ *
+ * const composio = new Composio({
+ *   apiKey: process.env.COMPOSIO_API_KEY,
+ *   provider: new ClaudeCodeAgentsProvider(),
+ * });
+ *
+ * // Get tools and create MCP server config using claude-agent-sdk's `createSdkMcpServer`
+ * const tools = await composio.tools.get('default', 'GMAIL_SEND_EMAIL');
+ * const mcpServer = createSdkMcpServer({
+ *   name: 'composio',
+ *   version: '1.0.0',
+ *   tools,
+ * });
+ *
+ * // Use with Claude Agent SDK
+ * for await (const message of query({
+ *   prompt: 'Send an email',
+ *   options: {
+ *     mcpServers: { composio: mcpServer },
+ *   },
+ * })) {
+ *   console.log(message);
+ * }
+ * ```
+ */
+declare class ClaudeCodeAgentsProvider extends BaseAgenticProvider<ClaudeAgentToolCollection, ClaudeAgentTool, McpServerGetResponse> {
+    readonly name = "claude-code-agents";
+    /**
+     * Wraps a Composio tool as a Claude Agent SDK MCP tool.
+     *
+     * @param composioTool - The Composio tool to wrap
+     * @param executeTool - Function to execute the tool
+     * @returns A Claude Agent SDK MCP tool definition
+     *
+     * @example
+     * ```typescript
+     * const composioTool = {
+     *   slug: 'GMAIL_SEND_EMAIL',
+     *   description: 'Send an email via Gmail',
+     *   inputParameters: {
+     *     type: 'object',
+     *     properties: {
+     *       to: { type: 'string', description: 'Recipient email' },
+     *       subject: { type: 'string', description: 'Email subject' },
+     *       body: { type: 'string', description: 'Email body' },
+     *     },
+     *     required: ['to', 'subject', 'body'],
+     *   },
+     * };
+     *
+     * const mcpTool = provider.wrapTool(composioTool, executeFn);
+     * ```
+     */
+    wrapTool(composioTool: Tool, executeTool: ExecuteToolFn): ClaudeAgentTool;
+    /**
+     * Wraps multiple Composio tools as Claude Agent SDK MCP tools.
+     *
+     * @param tools - Array of Composio tools to wrap
+     * @param executeTool - Function to execute the tools
+     * @returns Array of Claude Agent SDK MCP tool definitions
+     *
+     * @example
+     * ```typescript
+     * const tools = await composio.tools.get('default', ['GMAIL_SEND_EMAIL', 'SLACK_POST_MESSAGE']);
+     * const mcpTools = provider.wrapTools(tools, composio.tools.execute);
+     * ```
+     */
+    wrapTools(tools: Tool[], executeTool: ExecuteToolFn): ClaudeAgentToolCollection;
+    /**
+     * Transform MCP URL response into standard format.
+     *
+     * @param data - The MCP URL response data
+     * @returns Standard MCP server response format
+     */
+    wrapMcpServerResponse(data: McpUrlResponse): McpServerGetResponse;
+}
+
+export { type ClaudeAgentTool, type ClaudeAgentToolCollection, ClaudeCodeAgentsProvider };

package/dist/index.d.ts

@@ -0,0 +1,112 @@
+import { BaseAgenticProvider, McpServerGetResponse, Tool, ExecuteToolFn, McpUrlResponse } from '@composio/core';
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+export { Options as ClaudeAgentOptions } from '@anthropic-ai/claude-agent-sdk';
+
+/**
+ * Claude Code Agents Provider
+ * To be used with the Claude Agent SDK (@anthropic-ai/claude-agent-sdk)
+ *
+ * This provider enables integration with Claude Code Agents SDK,
+ * allowing Composio tools to be used as MCP tools within Claude agents.
+ *
+ * @packageDocumentation
+ * @module providers/claude-code-agents
+ */
+
+/**
+ * Type for a single Claude Agent SDK MCP tool definition
+ */
+type ClaudeAgentTool = ReturnType<typeof tool>;
+/**
+ * Type for a collection of Claude Agent SDK MCP tools
+ */
+type ClaudeAgentToolCollection = ClaudeAgentTool[];
+/**
+ * Provider for integrating Composio tools with Claude Code Agents SDK.
+ *
+ * This provider wraps Composio tools as MCP tools that can be used with
+ * the Claude Agent SDK's `query()` function via the `mcpServers` option.
+ *
+ * @example
+ * ```typescript
+ * import { Composio } from '@composio/core';
+ * import { ClaudeCodeAgentsProvider } from '@composio/claude-code-agents';
+ * import { query, createSdkMcpServer } from '@anthropic-ai/claude-agent-sdk';
+ *
+ * const composio = new Composio({
+ *   apiKey: process.env.COMPOSIO_API_KEY,
+ *   provider: new ClaudeCodeAgentsProvider(),
+ * });
+ *
+ * // Get tools and create MCP server config using claude-agent-sdk's `createSdkMcpServer`
+ * const tools = await composio.tools.get('default', 'GMAIL_SEND_EMAIL');
+ * const mcpServer = createSdkMcpServer({
+ *   name: 'composio',
+ *   version: '1.0.0',
+ *   tools,
+ * });
+ *
+ * // Use with Claude Agent SDK
+ * for await (const message of query({
+ *   prompt: 'Send an email',
+ *   options: {
+ *     mcpServers: { composio: mcpServer },
+ *   },
+ * })) {
+ *   console.log(message);
+ * }
+ * ```
+ */
+declare class ClaudeCodeAgentsProvider extends BaseAgenticProvider<ClaudeAgentToolCollection, ClaudeAgentTool, McpServerGetResponse> {
+    readonly name = "claude-code-agents";
+    /**
+     * Wraps a Composio tool as a Claude Agent SDK MCP tool.
+     *
+     * @param composioTool - The Composio tool to wrap
+     * @param executeTool - Function to execute the tool
+     * @returns A Claude Agent SDK MCP tool definition
+     *
+     * @example
+     * ```typescript
+     * const composioTool = {
+     *   slug: 'GMAIL_SEND_EMAIL',
+     *   description: 'Send an email via Gmail',
+     *   inputParameters: {
+     *     type: 'object',
+     *     properties: {
+     *       to: { type: 'string', description: 'Recipient email' },
+     *       subject: { type: 'string', description: 'Email subject' },
+     *       body: { type: 'string', description: 'Email body' },
+     *     },
+     *     required: ['to', 'subject', 'body'],
+     *   },
+     * };
+     *
+     * const mcpTool = provider.wrapTool(composioTool, executeFn);
+     * ```
+     */
+    wrapTool(composioTool: Tool, executeTool: ExecuteToolFn): ClaudeAgentTool;
+    /**
+     * Wraps multiple Composio tools as Claude Agent SDK MCP tools.
+     *
+     * @param tools - Array of Composio tools to wrap
+     * @param executeTool - Function to execute the tools
+     * @returns Array of Claude Agent SDK MCP tool definitions
+     *
+     * @example
+     * ```typescript
+     * const tools = await composio.tools.get('default', ['GMAIL_SEND_EMAIL', 'SLACK_POST_MESSAGE']);
+     * const mcpTools = provider.wrapTools(tools, composio.tools.execute);
+     * ```
+     */
+    wrapTools(tools: Tool[], executeTool: ExecuteToolFn): ClaudeAgentToolCollection;
+    /**
+     * Transform MCP URL response into standard format.
+     *
+     * @param data - The MCP URL response data
+     * @returns Standard MCP server response format
+     */
+    wrapMcpServerResponse(data: McpUrlResponse): McpServerGetResponse;
+}
+
+export { type ClaudeAgentTool, type ClaudeAgentToolCollection, ClaudeCodeAgentsProvider };

package/dist/index.js

@@ -0,0 +1,103 @@
+// src/index.ts
+import {
+  BaseAgenticProvider
+} from "@composio/core";
+import {
+  tool as sdkTool
+} from "@anthropic-ai/claude-agent-sdk";
+import { jsonSchemaToZodShape } from "@composio/json-schema-to-zod";
+var ClaudeCodeAgentsProvider = class extends BaseAgenticProvider {
+  name = "claude-code-agents";
+  /**
+   * Wraps a Composio tool as a Claude Agent SDK MCP tool.
+   *
+   * @param composioTool - The Composio tool to wrap
+   * @param executeTool - Function to execute the tool
+   * @returns A Claude Agent SDK MCP tool definition
+   *
+   * @example
+   * ```typescript
+   * const composioTool = {
+   *   slug: 'GMAIL_SEND_EMAIL',
+   *   description: 'Send an email via Gmail',
+   *   inputParameters: {
+   *     type: 'object',
+   *     properties: {
+   *       to: { type: 'string', description: 'Recipient email' },
+   *       subject: { type: 'string', description: 'Email subject' },
+   *       body: { type: 'string', description: 'Email body' },
+   *     },
+   *     required: ['to', 'subject', 'body'],
+   *   },
+   * };
+   *
+   * const mcpTool = provider.wrapTool(composioTool, executeFn);
+   * ```
+   */
+  wrapTool(composioTool, executeTool) {
+    const inputParams = composioTool.inputParameters ?? {};
+    const zodShape = jsonSchemaToZodShape(inputParams);
+    return sdkTool(
+      composioTool.slug,
+      composioTool.description ?? `Execute ${composioTool.slug}`,
+      zodShape,
+      async (args) => {
+        try {
+          const result = await executeTool(composioTool.slug, args);
+          return {
+            content: [
+              {
+                type: "text",
+                text: typeof result === "string" ? result : JSON.stringify(result) ?? ""
+              }
+            ]
+          };
+        } catch (error) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify({
+                  successful: false,
+                  error: error instanceof Error ? error.message : String(error),
+                  data: null
+                })
+              }
+            ]
+          };
+        }
+      }
+    );
+  }
+  /**
+   * Wraps multiple Composio tools as Claude Agent SDK MCP tools.
+   *
+   * @param tools - Array of Composio tools to wrap
+   * @param executeTool - Function to execute the tools
+   * @returns Array of Claude Agent SDK MCP tool definitions
+   *
+   * @example
+   * ```typescript
+   * const tools = await composio.tools.get('default', ['GMAIL_SEND_EMAIL', 'SLACK_POST_MESSAGE']);
+   * const mcpTools = provider.wrapTools(tools, composio.tools.execute);
+   * ```
+   */
+  wrapTools(tools, executeTool) {
+    return tools.map((tool) => this.wrapTool(tool, executeTool));
+  }
+  /**
+   * Transform MCP URL response into standard format.
+   *
+   * @param data - The MCP URL response data
+   * @returns Standard MCP server response format
+   */
+  wrapMcpServerResponse(data) {
+    return data.map((item) => ({
+      url: new URL(item.url),
+      name: item.name
+    }));
+  }
+};
+export {
+  ClaudeCodeAgentsProvider
+};

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@composio/claude-code-agents",
+  "version": "0.3.1",
+  "description": "Composio provider for Claude Code Agents SDK",
+  "main": "dist/index.js",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "README.md",
+    "dist"
+  ],
+  "keywords": [
+    "composio",
+    "claude",
+    "claude-code",
+    "agent-sdk",
+    "anthropic",
+    "mcp"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "zod": "^3.25.76",
+    "@composio/json-schema-to-zod": "0.1.19"
+  },
+  "peerDependencies": {
+    "@composio/core": "0.3.1",
+    "@anthropic-ai/claude-agent-sdk": ">=0.1.0"
+  },
+  "devDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.1.9",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4",
+    "zod": "^3.25.76",
+    "@composio/core": "0.3.1"
+  },
+  "scripts": {
+    "clean": "git clean -xdf node_modules",
+    "build": "tsup",
+    "test": "vitest run"
+  },
+  "types": "dist/index.d.ts"
+}