← Back to Blogs
guide · Jan 16, 2026 · 10 min read

Install MemoV MCP Fast: A Practical Setup Guide

Complete guide to installing MemoV with uv and connecting it to Claude Code, Codex, VS Code, Cursor, and Claude Desktop.

Install MemoV MCP Fast: A Practical Setup Guide

This guide walks you through installing MemoV and connecting it to your AI coding tools using the Model Context Protocol (MCP). The entire setup takes less than 5 minutes.

Prerequisites

Before installing MemoV, you need two things:

1. Install uv

code
uv
is a fast Python package manager that MemoV uses for installation:
macOS / Linux:
bash
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows:
powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Install Git

MemoV uses Git's storage format. Install Git if you don't have it:
  • macOS:
    code
    brew install git
  • Ubuntu/Debian:
    code
    sudo apt install git
  • Windows: Download from git-scm.com

Connect to Your AI Coding Tool

Choose your tool and follow the instructions:

Claude Code

Claude Code is Anthropic's official CLI. Add MemoV from your project directory:
bash
cd your-project claude mcp add mem-mcp --scope project -- uvx --from git+https://github.com/memovai/memov.git mem-mcp-launcher stdio $(pwd)
The
code
--scope project
flag limits MemoV to this project only.

Codex

For OpenAI's Codex:
bash
cd your-project codex mcp add mem-mcp -- uvx --from git+https://github.com/memovai/memov.git mem-mcp-launcher stdio $(pwd)

VS Code

Create
code
.vscode/mcp.json
in your project root:
json
{ "servers": { "mem-mcp": { "type": "stdio", "command": "uvx", "args": [ "--from", "git+https://github.com/memovai/memov.git", "mem-mcp-launcher", "stdio", "${workspaceFolder}" ] } } }
Reload VS Code to activate the MCP server.

Cursor

  1. Open Files > Preferences > Cursor Settings > MCP
  2. Add this configuration:
json
{ "mcpServers": { "mem-mcp": { "command": "uvx", "args": [ "--from", "git+https://github.com/memovai/memov.git", "mem-mcp-launcher", "stdio", "${workspaceFolder}" ] } } }
Note: Some editors (like Antigravity) don't support
code
${workspaceFolder}
. Use the absolute path instead.

Claude Desktop

Edit
code
~/.config/claude/claude_desktop_config.json
(Windows:
code
%APPDATA%\Claude\claude_desktop_config.json
):
json
{ "mcpServers": { "memov": { "command": "uvx", "args": [ "--from", "git+https://github.com/memovai/memov.git", "mem-mcp-launcher", "stdio", "." ] } } }

Enable RAG Mode (Optional)

For semantic search capabilities, install with the
code
[rag]
extras:
bash
claude mcp add mem-mcp --scope project -- uvx --from "git+https://github.com/memovai/memov.git[rag]" mem-mcp-launcher stdio $(pwd)
RAG mode enables natural language search across your session history.

Verify Installation

After connecting, verify MemoV is working:
  1. Start your AI coding tool
  2. Ask it to create or modify a file
  3. Run
    code
    mem history
    to see the captured session
You should see your prompt and the code changes recorded.

Troubleshooting

"uvx: command not found"

Reinstall uv and restart your terminal:
bash
curl -LsSf https://astral.sh/uv/install.sh | sh source ~/.bashrc # or ~/.zshrc

MCP Server Not Starting

  1. Verify uv is installed:
    code
    which uvx
  2. Test manual launch:
    code
    uvx --from git+https://github.com/memovai/memov.git mem-mcp-launcher stdio .
  3. Check your editor's MCP logs for errors

RAG Tools Not Available

If semantic search isn't working, reinstall with extras:
bash
uvx --from "git+https://github.com/memovai/memov.git[rag]" mem-mcp-launcher

Next Steps

Now that MemoV is installed: