Connect Convex to Your AI Agent

Understand your application’s environments and the results of its existing queries.

23 tools OAuth / API key

Try a Convex Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Convex

Compare a Project’s Deployments

Read deployment records to organize environment and configuration differences.

/oo Convex: Compare deployments for project [project identifier]. Summarize environment types, regions, and relevant configuration differences.

Summarize an Existing Query Function’s Output

Run the query path and arguments you supply and explain the result for a business or data question.

/oo Convex: Run the existing query [function] on [deployment] with [inputs]. Explain the result for [question], using these output notes: [notes].

Start Working with Convex

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Convex

    Authorize Convex through OAuth or connect with a deploy key.

    Connect Convex →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • Access to the intended Convex team, project, or deployment.
  • A deploy key for key-based access; available operations depend on the token’s authorization.
  • Function execution requires the target deployment URL.

Convex Tools

Inspect project deployments and invoke documented deployment functions. Query interpretation depends on the application, while mutations and actions can have side effects.

Read and Maintain Projects and Deployments

Read team projects and deployment details, create or update deployments, and list configured custom domains.

Execute Existing Functions

Run queries, mutations, actions, or batches of queries using supplied paths and arguments.

23 tools

Get Token Details

Return the current Convex token details so you can discover the authorized team or project context.

convex.get_token_details

List Projects

List all Convex projects for a team.

convex.list_projects

Create Project

Create a Convex project on a team, optionally provisioning an initial dev or prod deployment.

convex.create_project

Get Project By Id

Get a Convex project by numeric project ID.

convex.get_project_by_id

Get Project By Slug

Get a Convex project by team identifier or slug plus project slug.

convex.get_project_by_slug

Delete Project

Delete a Convex project and all of its deployments.

convex.delete_project

List Deployments

List deployments for a Convex project.

convex.list_deployments

Get Deployment

Get a cloud deployment by deployment name.

convex.get_deployment

Create Deployment

Create a new deployment in a Convex project.

convex.create_deployment

Update Deployment

Update mutable Convex deployment properties.

convex.update_deployment

Delete Deployment

Delete a Convex deployment and all of its data.

convex.delete_deployment

List Deployment Classes

List available deployment classes for a Convex team.

convex.list_deployment_classes

List Deployment Regions

List available deployment regions for a Convex team.

convex.list_deployment_regions

Create Deploy Key

Create a deploy key for a Convex deployment.

convex.create_deploy_key

List Deploy Keys

List deploy keys for a Convex deployment.

convex.list_deploy_keys

Delete Deploy Key

Delete a deploy key for a Convex deployment.

convex.delete_deploy_key

List Custom Domains

List custom domains configured for a Convex deployment.

convex.list_custom_domains

Delete Custom Domain

Remove a custom domain from a Convex deployment.

convex.delete_custom_domain

Run Query

Execute a Convex query through the deployment HTTP API.

convex.run_query

Run Mutation

Execute a Convex mutation through the deployment HTTP API.

convex.run_mutation

Run Action

Execute a Convex action through the deployment HTTP API.

convex.run_action

Run Function

Execute an arbitrary Convex function through `/api/run/{functionIdentifier}` using a slash-separated identifier.

convex.run_function

Execute Query Batch

Execute multiple Convex queries against a deployment and return results in the same order.

convex.execute_query_batch

Frequently Asked Questions

What does the assistant need to run a query?

Identify the existing function, target deployment, required inputs, and how its result should be interpreted.

Are all application functions read-only?

No. Queries read data; mutations and actions can change data or perform other work. Specify the intended function clearly.

Connect Convex

About Convex ↗