@mastra/convex

@mastra/convex provides Convex-backed storage, vector search, and server caching for Mastra applications. It includes development-scale and native vector implementations, along with server-side Convex definitions and handlers.

Installation

npm install @mastra/convex

Usage

Create a vector store with your Convex deployment URL and an admin auth token. Use ConvexNativeVector for production-scale native vector search, or ConvexVector for development-scale search implemented by the package.

import { ConvexNativeVector } from '@mastra/convex';

const vectorStore = new ConvexNativeVector({
  id: 'convex-vectors',
  deploymentUrl: process.env.CONVEX_URL!,
  adminAuthToken: process.env.CONVEX_ADMIN_KEY!,
});

await vectorStore.createIndex({ indexName: 'documents', dimension: 1536 });

Documentation

• Convex integration guide
• Convex vector reference

Changelog

See the package changelog for version history and release notes.

Support

We have an open community Discord. Come and say hello and let us know if you have any questions or need any help getting things running.