How to integrate Customgpt MCP with Claude Code

Manage your Customgpt directly from Claude Code with zero worries about OAuth hassles, API-breaking issues, or reliability and security concerns. You can do this in two different ways: Via Composio Connect - Direct and easiest approach Via Composio SDK - Programmatic approach with more control

Customgpt logoCustomgpt
Api Key

CustomGPT.ai lets you build and deploy chatbots tailored to your own data and business needs. Get precise and context-aware AI conversations without writing code.

40 Tools

Introduction

Manage your Customgpt directly from Claude Code with zero worries about OAuth hassles, API-breaking issues, or reliability and security concerns.

You can do this in two different ways:

  1. Via Composio Connect - Direct and easiest approach
  2. Via Composio SDK - Programmatic approach with more control

Also integrate Customgpt with

Why use Composio?

  • Only one MCP URL to connect multiple apps with Claude Code with zero auth hassles.
  • Programmatic tool calling allows LLMs to write its code in a remote workbench to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Handling Large tool responses out of LLM context to minimize context rot.
  • Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so LLMs aren't overwhelmed by tools you don't need.

Connecting Customgpt to Claude Code using Composio

1. Add the Composio MCP to Claude

Terminal

2. Start Claude Code

bash
claude

3. Open your MCP list

bash
/mcp

4. Select Composio and click on Authenticate

Select Composio and click Authenticate

5. This will redirect you to the Composio OAuth page. Complete the flow by authorizing Composio and you're all set.

Composio OAuth authorization page
Composio authorization complete
Ask Claude to connect to your account and authenticate via the link

What is the Customgpt MCP server, and what's possible with it?

The Customgpt MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your CustomGPT.ai account. It provides structured and secure access to your chatbot projects, so your agent can list, manage, update, and analyze your AI-powered chatbots and their licenses on your behalf.

  • Project and agent management: Effortlessly list all your CustomGPT projects, retrieve their details, and even delete agents you no longer need.
  • Comprehensive license handling: Let your agent fetch, update, or remove licenses attached to any of your chatbot projects, ensuring you always have the right access and compliance.
  • Chat conversation insights: Retrieve complete chat histories from your AI chatbot conversations to analyze user interactions or debug sessions.
  • User profile and usage monitoring: Automatically fetch your account profile and check on your usage limits, including agents, words, and queries, so you never exceed your quotas.
  • Project settings inspection: Quickly pull and review configuration details for any chatbot project to audit or adjust your bot's setup.

Connecting Customgpt via Composio SDK

Composio SDK is the underlying tech that powers Rube. It's a universal gateway that does everything Rube does but with much more programmatic control. You can programmatically generate an MCP URL with the app you need (here Customgpt) for even more tool search precision. It's secure and reliable.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step10 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Claude Pro, Max, or API billing enabled Anthropic account
  • Composio API Key
  • A Customgpt account
  • Basic knowledge of Python or TypeScript
2

Install Claude Code

bash
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

To install Claude Code, use one of the following methods based on your operating system:

3

Set up Claude Code

bash
cd your-project-folder
claude

Open a terminal, go to your project folder, and start Claude Code:

  • Claude Code will open in your terminal
  • Follow the prompts to sign in with your Anthropic account
  • Complete the authentication flow
  • Once authenticated, you can start using Claude Code
Claude Code initial setup showing sign-in prompt
Claude Code terminal after successful login
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here

Create a .env file in your project root with the following variables:

  • COMPOSIO_API_KEY authenticates with Composio (get it from Composio dashboard)
  • USER_ID identifies the user for session management (use any unique identifier)
5

Install Composio library

npm install @composio/core dotenv

Install the Composio TypeScript library to create MCP sessions.

  • @composio/core provides the core Composio functionality
  • dotenv loads environment variables from your .env file
6

Generate Composio MCP URL

import 'dotenv/config';
import { Composio } from '@composio/core';

const { COMPOSIO_API_KEY, USER_ID } = process.env;

if (!COMPOSIO_API_KEY || !USER_ID) {
  throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
}

const composioClient = new Composio({ apiKey: COMPOSIO_API_KEY });

const composioSession = await composioClient.create(USER_ID, {
  toolkits: ['customgpt'],
});

const composioMcpUrl = composioSession?.mcp.url;

console.log(`MCP URL: ${composioMcpUrl}`);
console.log(`\nUse this command to add to Claude Code:`);
console.log(`claude mcp add --transport http customgpt-composio "${composioMcpUrl}" --headers "X-API-Key:${COMPOSIO_API_KEY}"`);

Create a script to generate a Composio MCP URL for Customgpt. This URL will be used to connect Claude Code to Customgpt.

What's happening

  • We import the Composio client and load environment variables
  • Create a Composio instance with your API key
  • Call create() to create a Tool Router session for Customgpt
  • The returned mcp.url is the MCP server URL that Claude Code will use
  • The script prints this URL so you can copy it
7

Run the script and copy the MCP URL

node --loader ts-node/esm generate_mcp_url.ts
# or if using tsx
tsx generate_mcp_url.ts

Run your TypeScript script to generate the MCP URL.

  • The script connects to Composio and creates a Tool Router session
  • It prints the MCP URL and the exact command you need to run
  • Copy the entire claude mcp add command from the output
8

Add Customgpt MCP to Claude Code

bash
claude mcp add --transport http customgpt-composio "YOUR_MCP_URL_HERE" --headers "X-API-Key:YOUR_COMPOSIO_API_KEY"

# Then restart Claude Code
exit
claude

In your terminal, add the MCP server using the command from the previous step. The command format is:

  • claude mcp add registers a new MCP server with Claude Code
  • --transport http specifies that this is an HTTP-based MCP server
  • The server name (customgpt-composio) is how you'll reference it
  • The URL points to your Composio Tool Router session
  • --headers includes your Composio API key for authentication

After running the command, close the current Claude Code session and start a new one for the changes to take effect.

9

Verify the installation

bash
claude mcp list

Check that your Customgpt MCP server is properly configured.

  • This command lists all MCP servers registered with Claude Code
  • You should see your customgpt-composio entry in the list
  • This confirms that Claude Code can now access Customgpt tools

If everything is wired up, you should see your customgpt-composio entry listed:

Claude Code MCP list showing the toolkit MCP server
10

Authenticate Customgpt

The first time you try to use Customgpt tools, you'll be prompted to authenticate.

  • Claude Code will detect that you need to authenticate with Customgpt
  • It will show you an authentication link
  • Open the link in your browser (or copy/paste it)
  • Complete the Customgpt authorization flow
  • Return to the terminal and start using Customgpt through Claude Code

Once authenticated, you can ask Claude Code to perform Customgpt operations in natural language. For example:

  • "List all my active CustomGPT projects"
  • "Show chat history from my latest conversation"
  • "Get usage limits for my account"

Complete Code

Here's the complete code to get you started with Customgpt and Claude Code:

import 'dotenv/config';
import { Composio } from '@composio/core';

const { COMPOSIO_API_KEY, USER_ID } = process.env;

if (!COMPOSIO_API_KEY || !USER_ID) {
  throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
}

const composioClient = new Composio({ apiKey: COMPOSIO_API_KEY });

const composioSession = await composioClient.create(USER_ID, {
  toolkits: ['customgpt'],
});

const composioMcpUrl = composioSession?.mcp.url;

console.log(`MCP URL: ${composioMcpUrl}`);
console.log(`\nUse this command to add to Claude Code:`);
console.log(`claude mcp add --transport http customgpt-composio "${composioMcpUrl}" --headers "X-API-Key:${COMPOSIO_API_KEY}"`);

Conclusion

You've successfully integrated Customgpt with Claude Code using Composio's MCP server. Now you can interact with Customgpt directly from your terminal using natural language commands.

Key features of this setup:

  • Terminal-native experience without switching contexts
  • Natural language commands for Customgpt operations
  • Secure authentication through Composio's managed MCP
  • Tool Router for dynamic tool discovery and execution

Next steps:

  • Try asking Claude Code to perform various Customgpt operations
  • Add more toolkits to your Tool Router session for multi-app workflows
  • Integrate this setup into your development workflow for increased productivity

You can extend this by adding more toolkits, implementing custom workflows, or building automation scripts that leverage Claude Code's capabilities.

TOOLS

Supported Tools

Every Customgpt action and event your agent gets out of the box.

Activate Persona Version

Restore a previous persona version for a CustomGPT agent.

Add Source to Project

Add a data source to a CustomGPT agent's knowledge base.

Clone CustomGPT Project

Tool to clone a CustomGPT agent (project).

Create Conversation

Tool to create a new conversation session for a CustomGPT agent.

Create CustomGPT Project

Tool to create a new CustomGPT agent from a sitemap URL or file upload.

Delete Page from Agent

Tool to delete a document from a CustomGPT agent's knowledge base.

Delete CustomGPT Project

Tool to delete a CustomGPT project by ID.

Delete CustomGPT Project License

Deletes a license from a CustomGPT project/agent.

Delete CustomGPT Source

Tool to delete a data source from a CustomGPT agent.

Export Leads

Export leads from a CustomGPT project.

Get Message

Tool to get message details from a CustomGPT conversation.

Get Message Trust Score

Tool to retrieve verification trust score for a message in a CustomGPT conversation.

Get Page Metadata

Tool to get document metadata including title, source URL, word count, and custom metadata fields.

Get Agent Plugins

Tool to retrieve plugin details for a specific CustomGPT agent (project).

Get CustomGPT Project

Tool to get agent details.

Get Project License

Tool to retrieve a license for a specific project.

Get Project Settings

Retrieve configuration settings for a specific CustomGPT agent/project.

Get Analytics Chart Data

Tool to retrieve analytics chart data for a CustomGPT project.

Get Conversation Analytics

Tool to get conversation analytics for a CustomGPT project.

Get Customer Intelligence Report

Tool to get customer intelligence for a CustomGPT project.

Get Traffic Analytics Report

Tool to retrieve traffic analytics for a CustomGPT agent/project.

Get Agent Statistics

Tool to get agent statistics.

Get Usage Limits

Get account usage limits showing current usage vs.

Get Current User Profile

Tool to retrieve the current user's profile information.

List Conversation Messages

Retrieves all messages from a CustomGPT conversation, including both user queries and AI responses.

List Agent Documents

Lists all documents in a CustomGPT agent's knowledge base.

List Persona Versions

Tool to list persona versions for a CustomGPT agent.

List CustomGPT Project Licenses

List all licenses for a CustomGPT project/agent.

List CustomGPT Projects

Lists all CustomGPT projects (agents) for the authenticated user.

List Agent Sources

Tool to list all data sources connected to an agent.

Reindex Page

Tool to reindex a document in CustomGPT knowledge base.

Search Team Members

Tool to search for team members by email address or user ID.

Submit Message Feedback

Tool to submit feedback (thumbs up/down) for a message in a CustomGPT conversation.

Update Page Metadata

Update document metadata for a specific page in a CustomGPT project.

Update Project

Updates an existing CustomGPT agent's name or configuration settings.

Update Project License

Updates the name of an existing license for a CustomGPT project/agent.

Update Project Settings

Update CustomGPT agent configuration settings.

Update Source Settings

Update source settings for a CustomGPT agent data source.

Update User Profile

Updates the authenticated user's profile information in CustomGPT.

Verify Message Accuracy

Tool to verify message accuracy by triggering a fact-checking verification process.

FAQ

Frequently asked questions

With a standalone Customgpt MCP server, the agents and LLMs can only access a fixed set of Customgpt tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Customgpt and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Code fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Customgpt tools.

Yes, absolutely. You can configure which Customgpt scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Customgpt data and credentials are handled as safely as possible.

Start with Customgpt.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Customgpt tool your agent needs.Free to start.

Start building