Memvid MCP Server

An Model Context Protocol (MCP) server for Memvid, enabling AI agents to use persistent, file-based memory.

Features

• Project-based Memory: Create and manage isolated memory files (.mv2) for different projects.
• Add Content: Store text documents, code snippets, and metadata.
• Semantic Search: Find relevant content using Memvid's hybrid search (lexical + semantic).
• Ask Memory (Optional): Ask natural language questions about your stored data (requires OpenAI API Key).

Installation

npm install -g memvid-mcp-server
# or
bun add -g memvid-mcp-server

Configuration

This server can be used with any MCP-compliant client (e.g., Claude Desktop, Cursor).

Environment Variables

| Variable | Description | Required | | ---------------------- | -------------------------------------------------------------------------------------------------------- | ------------- | | OPENAI_API_KEY | Your OpenAI API Key. Required to enable the ask_memory tool and for semantic embeddings in some modes. | No (Optional) | | MEMVID_LOCAL_STORAGE | Set to "1" to store memory files in ./memvid_mcp (current directory) instead of ~/.memvid_mcp. | No (Optional) |

Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "memvid": {
      "command": "npx",
      "args": ["-y", "memvid-mcp-server@latest"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "MEMVID_LOCAL_STORAGE": "0"
      }
    }
  }
}

Note: If you do not provide OPENAI_API_KEY, the ask_memory tool will not be available, but you can still use create_or_open_memory, add_content, and search_memory (lexical mode).

Tools

1. create_or_open_memory: Initialize a new project memory or open an existing one.

   • project_name (string): Unique identifier for the project.
   • storage_path (string, optional): Absolute path to the PARENT directory (e.g., project root). The server creates a memvid_mcp folder inside this path.

2. add_content: Add text and metadata to the memory.

   • project_name (string): Unique identifier.
   • content (string): Text content to store.
   • storage_path (string, optional): Absolute path to storage directory.

3. search_memory: Search your memory.

   • project_name (string): Unique identifier.
   • query (string): Search query (use * for all recent items).
   • storage_path (string, optional): Absolute path to storage directory.

4. ask_memory: (Optional) Ask questions about your memory using an LLM.

   • project_name (string): Unique identifier.
   • question (string): Question to ask.
   • storage_path (string, optional): Absolute path to storage directory.

5. memvid_delete_project: Delete a project's memory.

   • project_name (string): Unique identifier.
   • storage_path (string, optional): Absolute path to storage directory.

Tip: All tools accept an optional storage_path argument. This allows the client to explicitly define where the memory project is stored, overriding the default behavior. Useful for containerized environments.

Development

# Install dependencies
bun install

# Run locally
bun run src/index.ts

# Build
bun build ./src/index.ts --compile --outfile server

Credits

This MCP Server is a wrapper around the powerful Memvid SDK. Full credit goes to the Memvid team for their excellent technology.

• NPM Package: @memvid/sdk
• Documentation: docs.memvid.com