How do I use memvid-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@memvid-mcp search for 'API endpoints' in my project-notes.mv2 file" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

memvid-mcp

MCP (Model Context Protocol) server for the memvid CLI - a memory layer for AI agents.

This server wraps the memvid Rust CLI binary, exposing all 40 commands as MCP tools. Compatible with both memvid (official) and memvid-unlocked binaries.

Prerequisites

Node.js 18+
memvid CLI binary installed and accessible

Installation

git clone https://github.com/Tapiocapioca/memvid-mcp.git cd memvid-mcp npm install npm run build

Configuration

Environment Variable	Default	Description
`MEMVID_PATH`	`memvid`	Path to the memvid binary
`MEMVID_TIMEOUT`	`120000`	Default command timeout (ms)
`MEMVID_VERBOSE`	`0`	Set to `1` for verbose logging
`MEMVID_LOG_LEVEL`	`warning`	Log level: `debug`, `info`, `warning`, `error`

MCP Client Setup

Claude Desktop

Add to claude_desktop_config.json:

{ "mcpServers": { "memvid": { "command": "node", "args": ["C:/AI/memvid-mcp/dist/index.js"], "env": { "MEMVID_PATH": "C:/Tools/bin/memvid.exe" } } } }

Cursor

Add to MCP settings:

{ "memvid": { "command": "node", "args": ["/path/to/memvid-mcp/dist/index.js"], "env": { "MEMVID_PATH": "/path/to/memvid" } } }

Available Tools (40)

Lifecycle (5)

Tool	Description
`memvid_create`	Create a new .mv2 memory file
`memvid_open`	Open and display file information
`memvid_stats`	Show statistics
`memvid_verify`	Verify file integrity
`memvid_doctor`	Diagnose and repair

Write Operations (7)

Tool	Description
`memvid_put`	Add content from file/directory
`memvid_put_many`	Batch add with progress
`memvid_view`	View frame content
`memvid_update`	Update frame content
`memvid_delete`	Delete a frame
`memvid_correct`	Correct/amend a frame
`memvid_api_fetch`	Fetch URL and add

Search (5)

Tool	Description
`memvid_find`	Hybrid/lexical/vector search
`memvid_vec_search`	Vector-only similarity search
`memvid_ask`	RAG question answering
`memvid_timeline`	Chronological view
`memvid_when`	Temporal search

Analysis (6)

Tool	Description
`memvid_audit`	Generate audit report
`memvid_debug_segment`	Debug internal segments
`memvid_export`	Export to JSON/CSV/JSONL
`memvid_tables`	List internal tables
`memvid_schema`	Schema operations
`memvid_models`	List available models

Knowledge Graph (6)

Tool	Description
`memvid_enrich`	NER entity extraction
`memvid_memories`	Memory card operations
`memvid_state`	State management
`memvid_facts`	Fact extraction
`memvid_follow`	Follow entity relationships
`memvid_who`	Entity lookup

Session (5)

Tool	Description
`memvid_session`	Session management
`memvid_binding`	Memory binding
`memvid_status`	System status
`memvid_sketch`	SimHash sketches
`memvid_nudge`	Trigger background processing

Crypto (2)

Tool	Description
`memvid_lock`	Encrypt file
`memvid_unlock`	Decrypt file

Utility (4)

Tool	Description
`memvid_process_queue`	Process pending operations
`memvid_verify_single_file`	Verify single frame
`memvid_config`	Show configuration
`memvid_version`	Print version

Example Workflow

1. memvid_create { "file": "project.mv2" } 2. memvid_put { "file": "project.mv2", "input": "./docs", "recursive": true } 3. memvid_find { "file": "project.mv2", "query": "authentication", "limit": 5 } 4. memvid_ask { "file": "project.mv2", "question": "How does the auth system work?" } 5. memvid_export { "file": "project.mv2", "output": "backup.json" }

Development

npm run dev # Run with tsx (development) npm run build # Compile TypeScript npm start # Run compiled version

License

MIT

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Tools

View all tools

memvid-mcp

memvid-mcp

Prerequisites

Installation

Configuration

MCP Client Setup

Claude Desktop

Cursor

Available Tools (40)

Lifecycle (5)

Write Operations (7)

Search (5)

Analysis (6)

Knowledge Graph (6)

Session (5)

Crypto (2)

Utility (4)

Example Workflow

Development

License

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API