How to connect Convex to Claude Cowork

Cowork is Anthropic's AI agent for knowledge work. Think of it as Claude Code for everything else. It works autonomously with your computer, local files, and applications to accomplish complex tasks. This guide walks you through the easiest and most secure way to connect your Convex account to Cowork via Composio Connect, enabling it to list records from Convex tasks table, run Convex query for active users, inspect Convex deployment function logs, and more such actions on your behalf without compromising your account security.

Convex logoConvex
Api KeyBearer Token

Convex is a Backend-as-a-Service platform with a real-time database, serverless functions, and built-in authentication. Use it to build reactive apps faster without managing backend infrastructure.

19 Tools

Introduction

Cowork is Anthropic's AI agent for knowledge work. Think of it as Claude Code for everything else. It works autonomously with your computer, local files, and applications to accomplish complex tasks.

This guide walks you through the easiest and most secure way to connect your Convex account to Cowork via Composio Connect, enabling it to list records from Convex tasks table, run Convex query for active users, inspect Convex deployment function logs, and more such actions on your behalf without compromising your account security.

Also integrate Convex with

Connecting Convex to Claude Cowork

1. Open Customize

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

2. Add the Composio MCP server

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

3. 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 Cowork

4. Connect your Convex account

Back in Cowork, ask the agent to connect to Convex or give it any Convex-related task.

For example, ask Cowork to:

  • "List records from Convex tasks table"
  • "Run Convex query for active users"
  • "Inspect Convex deployment function logs"

It will prompt you to authenticate and authorize access.

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

What is Claude Cowork?

Claude Cowork is Anthropic's agent for general knowledge work. It can use your computer, files, and connected applications to complete longer-running tasks across your work tools.

With Composio Connect, Cowork can securely access apps like Convex through MCP without you sharing account credentials directly with the agent.

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

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

TOOLS

Supported Tools

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

Create deploy key

Tool to create a deploy key for use with the Convex CLI.

Create Deployment

Tool to create a new deployment for a Convex project.

Create Project

Tool to create a new project on a Convex team, optionally provisioning a dev or prod deployment.

Delete Custom Domain

Tool to remove a custom domain from a Convex deployment.

Delete Deployment

Tool to delete a Convex deployment.

Delete project

Deletes a Convex project and all its deployments permanently.

Execute Query Batch

Tool to execute multiple Convex query functions in a single batch request.

Get Deployment Details

Tool to retrieve details about a Convex cloud deployment.

Get Project by ID

Tool to retrieve detailed information about a specific Convex project by its ID.

Get Project by Slug

Tool to retrieve a Convex project by its slug within a team.

Get Query Timestamp

Tool to get the latest timestamp for queries from Convex deployment.

Get token details

Tool to retrieve token details for the authenticated token.

List Deploy Keys

Tool to list all deploy keys for a specified Convex deployment.

List deployment classes

Tool to list available deployment classes for a Convex team.

List deployment regions

Tool to list available deployment regions for a Convex team.

List Deployments

Tool to list all deployments for a Convex project.

List Log Streams

Tool to list all existing log stream configurations in a deployment.

List Projects

Tool to list all projects for a specific Convex team.

Update Deployment

Tool to update properties of an existing Convex deployment.

FAQ

Frequently asked questions

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

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

Start with Convex.It takes 30 seconds.

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

Start building