Integration · Databases
AI agents for Convex
Call the query, mutation and action functions of a Convex deployment over its HTTP API, with the deployment's deploy key.
- Actions
- 3
- Read
- 1
- Write
- 2
Actions
What your agents can do in Convex
Call the query, mutation and action functions of a Convex deployment over its HTTP API, with the deployment's deploy key: read data through your queries, change it through your mutations, and run actions that reach other services. Works with Convex Cloud and self-hosted Convex.
Read 1
Look things up. Nothing changes.
Run a query function
Calls one of the deployment's public query functions by its path and returns what it returns.
Write 2
Create, change or send.
Run a mutation function
Calls one of the deployment's public mutation functions by its path, in one transaction, and returns what it returns.
Run an action function
Calls one of the deployment's public action functions by its path and waits for it to finish.
A person can approve first
Any write action can be set to wait for a person's approval before it runs, so an agent asks before it changes anything.
Connection
How it connects
Connect it once in the console, then give it to the agents and workflows that need it.
Paste an API key from your Convex account.
What you enter
- Deploy key
Settings
- Deployment URL
Kept safe
- Credentials are stored encrypted with your organization's own keys.
- They are opened only by the process that makes the call, at the moment it runs, and never go into a prompt or the browser.
- Calls go only to the tool's own servers.
Ideas
Ideas to start with
Starting points made only from the actions above. Mix them with any other tool your agents can use.
- 01
Ask about your Convex data
Ask a question in plain words. The agent can run a query function in Convex, then answers with what it found.
- 02
Let an agent update Convex
Have the agent run a mutation function or run an action function in Convex as part of a larger task. Turn on approval and a person signs off on each change first.
- 03
Share what it finds in Slack
Give one agent Convex and Slack: it can run a query function in Convex and post a summary to a Slack channel in the same run.
Works well with
More Databases tools
- PostgreSQL5 actionsRead and query a PostgreSQL database directly: Amazon RDS and Aurora, Google Cloud SQL, Azure, Neon, Supabase, or your own server with a public address.
- MySQL5 actionsRead and query a MySQL database directly: Amazon RDS and Aurora MySQL, Google Cloud SQL, Azure, PlanetScale, or your own server with a public address.
- MongoDB7 actionsRead and query a MongoDB database directly: MongoDB Atlas (mongodb+srv) or your own server with a public address.
- BigQuery5 actionsRun SQL on BigQuery, browse datasets, tables and their columns, and stream rows into a table, in a Google Cloud project, signed in with the person's own Google account.
- Snowflake9 actionsRun read-only SQL in Snowflake and page through the results, and list databases, schemas, tables, columns and warehouses, through the SQL API with a programmatic access token or a key pair.
- Pinecone8 actionsSearch, add, read and delete vectors in a Pinecone index: similarity search by vector or by a stored record's ID, text search on indexes with integrated embedding, index statistics and the list of indexes in the project.
FAQ
Convex and MyDeepAgents
Can MyDeepAgents connect to Convex?
Yes. The Convex connector has 3 actions: 1 reads and 2 make changes. Your agents can call them as tools, and your workflows can run them as steps.
How do I connect Convex?
Paste an API key from your Convex account. You'll need: Deploy key. The connection also asks for: Deployment URL. Credentials are stored encrypted with your organization's own keys and are opened only at the moment of a call.
Can an agent change data in Convex without asking?
Only if you let it. Each of the 2 actions that change data can be set to wait for a person's approval before it runs.
Can I use Convex in workflows as well as agents?
Yes. Every Convex action also works as a step in a workflow, and the same connection serves your agents and your workflows.
Early access
Put Convex to work
Connect it in a few minutes, give an agent the actions it needs, and decide which changes wait for a person.