How to connect DeployHQ to Claude

Connect Claude Web, Desktop and Cowork to DeployHQ MCP. Trigger a deployment for project x, list all deployments for project y, and more using natural language, with authentication handled for you.

Get started for free Get a demo

DeployHQ

Basic

DeployHQ is a deployment automation service for Git, SVN, and Mercurial projects. It streamlines code deployments, making project launches seamless and reliable.

61 Tools

Managed auth

Connect DeployHQ 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 DeployHQ account to Claude via Composio Connect, enabling it to trigger a deployment for Project X, list all deployments for Project Y, get status of last deployment, 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 DeployHQ with

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

Connecting DeployHQ 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 DeployHQ account

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

For example, ask Claude to:

"Trigger a deployment for Project X"
"List all deployments for Project Y"
"Get status of last deployment"

It will prompt you to authenticate and authorize access.

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

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

The DeployHQ MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your DeployHQ account. It provides structured and secure access so your agent can perform DeployHQ operations on your behalf.

Troubleshooting

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

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

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

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

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

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 DeployHQ.
If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the DeployHQ authorization link not work?

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

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

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

The DeployHQ connection can expire or lose permission.

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

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

Claude can manage the DeployHQ connection for you.

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

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

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

In Claude Desktop, open Customize > Connectors.
Next to Composio, click ⋮ and click Clear cache.
If DeployHQ 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 DeployHQ.

TOOLS

Supported Tools

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

Delete Command

Tool to delete a command from a specified project.

Delete Project

Tool to delete a project from DeployHQ.

Delete Build Cache File

Tool to delete an existing build cache file from a project.

Delete Excluded File Rule

Tool to delete an existing excluded file rule from a project.

Delete Server Group

Tool to delete a server group from a project using the DeployHQ API.

Delete Template

Tool to delete a template by its unique permalink.

Get Projects

Tool to retrieve all projects from DeployHQ account.

Get Project

Tool to view an existing project in DeployHQ.

Get Project Build Known Hosts

Tool to list all known hosts within a project using DeployHQ API.

Get Project Commands

Tool to retrieve all SSH commands configured for a project.

Get Project Config Files

Tool to retrieve a list of all config files in a DeployHQ project.

Get Project Deployments

Tool to retrieve a paginated list of all deployments in a project.

Get Project Excluded Files

Tool to list all excluded files within a project template.

Get Config File

Tool to view a specific config file in a DeployHQ project.

Get Excluded File

Tool to view a specific excluded file in a DeployHQ project.

Get Server Group

Tool to view a specific server group in a DeployHQ project.

Get Project Repository

Tool to view repository details for a specific project in DeployHQ.

Get Repository Branches

Tool to view all available branches in the connected repository for a project.

Get Repository Commit Info

Tool to view detailed information about a specific revision in a project's connected repository.

Get Latest Repository Revision

Tool to view the latest remote revision of your repository.

Get Recent Commits and Tags

Tool to view up to 15 most recent revisions and up to 15 most recent tags in a specific branch.

Get Project Scheduled Deployments

Tool to retrieve all upcoming scheduled deployments for a project.

Get Project Server Groups

Tool to retrieve all server groups configured for a project.

Get Project Servers

Tool to retrieve all servers configured for a project.

Get Templates

Tool to retrieve all templates from DeployHQ account.

Get Public Template

Tool to retrieve a specific public template from DeployHQ.

Get Public Templates

Tool to retrieve publicly available deployment templates from DeployHQ.

Update Project

Tool to update project settings in DeployHQ.

Update Build Cache File

Tool to update an existing build cache file in a project.

Update Build Command

Tool to update an existing build command in a project.

Update Language Version

Tool to update the version of a language in a project's build environment.

Update Project Command

Tool to update an existing SSH command in a project.

Update Config File

Tool to update an existing config file in a DeployHQ project.

Update Excluded File

Tool to update an existing excluded file rule in a project.

Update Project Repository

Tool to update repository configuration for a project in DeployHQ.

Update Server Group

Tool to update an existing server group in a DeployHQ project.

Update Template

Tool to update an existing template in DeployHQ.

Create Project

Tool to create a new project in DeployHQ.

Generate AI Deployment Overview

Tool to generate an AI-powered deployment overview for a revision range.

Create Build Cache File

Tool to create a new build cached file within a project.

Create Build Command

Tool to create a new build command for a project in DeployHQ.

Create Project Build Known Host

Tool to create a new known host in a project using DeployHQ API.

Create SSH Command

Tool to create a new SSH command for a project in DeployHQ.

Create Config File

Tool to create a new config file in a DeployHQ project.

Create Config File Deployment

Tool to create a new config file deployment for a project.

Create Excluded File

Tool to add a new excluded file to a project.

Abort Deployment

Tool to abort a currently running deployment.

Add Project Repository

Tool to add repository details to a project in DeployHQ.

Create Server Group

Tool to create a new server group for automated deployments in a DeployHQ project.

Create Server

Tool to create a new server configuration in a DeployHQ project.

Create Template

Tool to create a new template in DeployHQ.

Update Project Settings

Tool to update settings of an existing DeployHQ project.

Edit Build Cache File

Tool to edit an existing build cache file within a project.

Edit Build Command

Tool to edit an existing build command within a template in DeployHQ.

Edit SSH Command

Tool to edit an existing SSH command in a DeployHQ project.

Edit Config File

Tool to edit an existing config file within a project.

Edit Excluded File

Tool to edit an existing excluded file rule within a project.

Update Excluded File

Tool to update an existing excluded file rule in a project.

Update Project Repository

Tool to update repository details for an existing project in DeployHQ.

Update Server Group

Tool to update a server group in a DeployHQ project using the API.

Edit Template

Tool to edit an existing template in DeployHQ.

FRAMEWORKS

How to build DeployHQ MCP Agent with another framework

Claude Code

Use DeployHQ MCP with Claude Code

OpenAI Agents SDK

Use DeployHQ MCP with OpenAI Agents SDK

Claude Agent SDK

Use DeployHQ MCP with Claude Agent SDK

Grok Bot

Use DeployHQ MCP with Grok Bot

Codex

Use DeployHQ MCP with Codex

OpenClaw

Use DeployHQ MCP with OpenClaw

Hermes

Use DeployHQ MCP with Hermes

Atomic Agent

Use DeployHQ MCP with Atomic Agent

Google ADK

Use DeployHQ MCP with Google ADK

LangChain

Use DeployHQ MCP with LangChain

Vercel AI SDK

Use DeployHQ MCP with Vercel AI SDK

Mastra AI

Use DeployHQ MCP with Mastra AI

LlamaIndex

Use DeployHQ MCP with LlamaIndex

CrewAI

Use DeployHQ MCP with CrewAI

Pydantic AI

Use DeployHQ MCP with Pydantic AI

AutoGen

Use DeployHQ 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 DeployHQ MCP server, the agents and LLMs can only access a fixed set of DeployHQ tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from DeployHQ 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 DeployHQ tools.

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

Start with DeployHQ.It takes 30 seconds.

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

Start building