How to connect Bonsai to Claude

Connect Claude Web, Desktop and Cowork to Bonsai MCP. Show all bonsai server spaces for your account, get details of the 'us-east-1' cluster, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Bonsai

Basic

Bonsai is an all-in-one business management platform for freelancers and agencies. It streamlines contracts, invoicing, client CRM, and project workflows in a single dashboard.

3 Tools

Managed auth

Connect Bonsai without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Bonsai account to Claude via Composio Connect, enabling it to show all Bonsai server spaces for your account, get details of the 'us-east-1' cluster, retrieve metadata for a specific Bonsai space, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Bonsai with

Claude Code OpenAI Agents SDK Claude Agent SDK Codex OpenClaw Hermes Atomic Agent Google ADK LangChain Vercel AI SDK Mastra AI LlamaIndex CrewAI Pydantic AI AutoGen

Connecting Bonsai to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash

https://connect.composio.dev/mcp

Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Bonsai account

Back in Claude, ask it to connect to Bonsai or give it any Bonsai-related task.

For example, ask Claude to:

"Show all Bonsai server spaces for your account"
"Get details of the 'us-east-1' cluster"
"Retrieve metadata for a specific Bonsai space"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Bonsai account is ready to use.

What is the Bonsai Claude Connector, and what's possible with it?

The Bonsai MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Bonsai account. It provides structured and secure access to your Bonsai clusters and spaces, so your agent can perform actions like inspecting cluster details, listing available spaces, and retrieving specific space metadata on your behalf.

Cluster detail inspection: Instantly retrieve detailed information about any Bonsai cluster by slug, allowing your agent to check configurations and monitor status.
Comprehensive space listing: Ask your agent to fetch a list of all available spaces, making it easy to see your server groups and geographic regions at a glance.
Space metadata retrieval: Quickly get detailed metadata for a specific Bonsai space by its path, so you can confirm crucial details before provisioning or making changes.
Multi-region and group awareness: Empower your agent to help you understand the distribution and organization of your Bonsai resources across different regions and groups.

Troubleshooting

1. Why does Claude not use the Composio connector for Bonsai?

The connector can show as connected, but Claude must use it in each Bonsai conversation.

Click + at the lower left of the chat, or type /.
Hover Connectors.
Turn on Composio.
Ask Claude to connect to Bonsai again.

2. Why does Claude show an MCP server error before Bonsai connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Bonsai.

Check that the connector URL is https://connect.composio.dev/mcp.
Connectors run from Anthropic's cloud, so your device network is usually not the problem.
Add the connector again from Customize > Connectors, then ask Claude to connect Bonsai.
If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Bonsai authorization link not work?

The Composio connector is one server. Your Bonsai account connects separately when Claude asks for it.

If the browser does not open, or the link expires, ask Claude to retry the Bonsai connection.
Composio creates a fresh Bonsai authorization link.
Open that link in your browser and finish the Bonsai sign-in.

4. Why do Bonsai actions fail after they worked before?

The Bonsai connection can expire or lose permission.

Ask Claude to inspect the Bonsai connection.
If the connection is unhealthy, disconnect it when Claude prompts you.
Reconnect the Bonsai account and retry the action.
If Claude shows a permission prompt, approve it before Claude changes data in Bonsai.
If the action still fails with a permission error, check that the connected account has that permission in Bonsai itself.

5. How do I switch to a different Bonsai account?

Claude can manage the Bonsai connection for you.

Ask Claude to disconnect or delete the current Bonsai account.
Ask Claude to connect Bonsai again.
Open the new Composio authorization link for Bonsai.
Sign in with the other Bonsai account in the browser.
After the account connects, ask Claude to retry the Bonsai task.

6. Why is my Bonsai connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Bonsai connection works in Claude Web, Desktop, and Cowork.

In Claude Desktop, open Customize > Connectors.
Next to Composio, click ⋮ and click Clear cache.
If Bonsai tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Bonsai.

TOOLS

Supported Tools

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

Get Bonsai Cluster Details

Tool to retrieve details for a single bonsai cluster by slug.

Retrieve Space Details

Tool to retrieve details for a single space by its path.

List Spaces

Tool to retrieve a list of all available spaces.

FRAMEWORKS

How to build Bonsai MCP Agent with another framework

Claude Code

Use Bonsai MCP with Claude Code

OpenAI Agents SDK

Use Bonsai MCP with OpenAI Agents SDK

Claude Agent SDK

Use Bonsai MCP with Claude Agent SDK

Codex

Use Bonsai MCP with Codex

OpenClaw

Use Bonsai MCP with OpenClaw

Hermes

Use Bonsai MCP with Hermes

Atomic Agent

Use Bonsai MCP with Atomic Agent

Google ADK

Use Bonsai MCP with Google ADK

LangChain

Use Bonsai MCP with LangChain

Vercel AI SDK

Use Bonsai MCP with Vercel AI SDK

Mastra AI

Use Bonsai MCP with Mastra AI

LlamaIndex

Use Bonsai MCP with LlamaIndex

CrewAI

Use Bonsai MCP with CrewAI

Pydantic AI

Use Bonsai MCP with Pydantic AI

AutoGen

Use Bonsai MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Supabase

Oauth2Api Key

Supabase is an open-source backend platform offering scalable Postgres databases, authentication, storage, and real-time APIs. It lets developers build modern apps without managing infrastructure.

Codeinterpreter

No Auth

Codeinterpreter is a Python-based coding environment with built-in data analysis and visualization. It lets you instantly run scripts, plot results, and prototype solutions inside supported platforms.

GitHub

Oauth2

GitHub is a code hosting platform for version control and collaborative software development. It streamlines project management, code review, and team workflows in one place.

1password

Api Key

1Password is a password manager and digital vault for storing logins, secrets, notes, and secure documents. It helps individuals and teams protect credentials, share access safely, and reduce password risk.

FAQ

Frequently asked questions

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

Yes, you can. Claude Cowork 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 Bonsai tools.

Yes, absolutely. You can configure which Bonsai 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 Bonsai data and credentials are handled as safely as possible.

Start with Bonsai.It takes 30 seconds.

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

Start building