Install MiniMe in 5 Minutes

Get Recallium MiniMe Community Edition running in under 5 minutes. Works with Cursor, VS Code, Claude Desktop, Windsurf, and JetBrains IDEs.

What is Recallium MiniMe?

Recallium MiniMe Community Edition is an AI memory and project intelligence server that enables persistent, context-aware assistance directly in your IDE (Cursor, VS Code, Claude Desktop). It uses the Model Context Protocol (MCP) to provide tools for storing, searching, and reasoning about your code, decisions, and project knowledge—creating a digital memory that persists across sessions and grows smarter over time.

Repository: MiniMe-MCP on GitHub

Prerequisites

1. Docker

Install Docker for your platform:

Install Docker →

2. Ollama (for free local AI)

Install Ollama:

# macOS
brew install ollama

# Linux
curl -fsSL https://ollama.ai/install.sh | sh

# Windows
# Download from https://ollama.ai/download

Start Ollama:

ollama serve

Pull required models:

# Required for insights (or use OpenAI/Anthropic)
ollama pull qwen2.5-coder:7b

Note: No npm Client Needed (For Most IDEs)

Recallium MiniMe Community Edition now uses HTTP transport - most modern IDEs connect directly to the Docker container:

✅ No npm client needed (HTTP): Cursor, VS Code, Claude Code, Windsurf, and 10+ other IDEs
⚠️ npm client required (STDIO→HTTP bridge): Claude Desktop, Zed, JetBrains, Cline, BoltAI, and other command-only IDEs

Why does Claude Desktop need the npm client? Claude Desktop does not support HTTP MCP servers with localhost (non-HTTPS) URLs. The npm client acts as a bridge: it accepts STDIO commands from Claude Desktop and forwards them via HTTP to the MiniMe server.

If your IDE requires the npm client, install it:

npm install -g @minimemcp/mcp-client

Quick Start

Step 1: Clone the Repository

First, clone the Recallium MiniMe Community Edition repository to your local machine:

git clone https://github.com/manujbawa/minime-mcp.git
cd minime-mcp

The repository contains the Docker configuration, installation scripts, and all necessary files to get MiniMe-MCP running.

Step 2: Optional - Configure Ports (Before Starting)

If you need to change default ports (e.g., port 9000 is already in use), edit minime.env before running docker compose:

# Edit install/minime.env and change HOST port mappings:
HOST_UI_PORT=9001        # Access UI at localhost:9001 (default: 9000)
HOST_MCP_PORT=8001       # Access MCP API at localhost:8001 (default: 8000)
HOST_POSTGRES_PORT=5433  # Access PostgreSQL at localhost:5433 (default: 5432)

⚠️ Important: If you change HOST_MCP_PORT from the default 8000, you must also update your IDE's MCP client configuration to use the new port.

Step 3: Start Recallium MiniMe

Navigate to the install directory and start Recallium MiniMe Community Edition with Docker:

cd install
docker compose --env-file minime.env up -d

That's it! Access Recallium MiniMe at:

Web UI: http://localhost:9000 (or your configured HOST_UI_PORT)
MCP API: http://localhost:8000 (or your configured HOST_MCP_PORT)
Health Check: http://localhost:8000/health

HTTP Setup (Recommended - No npm Client)

These IDEs connect directly to http://localhost:8000/mcp without needing the npm client:

Install in Cursor

Go to: Settings → Cursor Settings → MCP → Add new global MCP server

Configuration:

{
  "mcpServers": {
    "minime": {
      "url": "http://localhost:8000/mcp",
      "transport": "http"
    }
  }
}

Or manually edit config file:

macOS: ~/.cursor/mcp.json
Windows: %APPDATA%\\Cursor\\mcp.json
Linux: ~/.config/cursor/mcp.json

Verification: Restart Cursor after adding configuration. Test with: "Use the store_memory tool to save this information"

Install in VS Code

Prerequisites:

VS Code version 1.102+ (or VS Code Insiders 1.103+)
GitHub Copilot Chat extension v0.29+

Method 1: Using Command Palette (Recommended)

Press Ctrl/Cmd + Shift + P
Type and select: MCP: Add Server
Choose: HTTP
Enter URL: http://localhost:8000/mcp
Enter name: minime

Method 2: Manual Configuration

Add this to your VS Code MCP config file:

macOS: ~/Library/Application Support/Code/User/mcp.json
Windows: %APPDATA%\\Code\\User\\mcp.json
Linux: ~/.config/Code/User/mcp.json

{
  "mcp": {
    "servers": {
      "minime": {
        "type": "http",
        "url": "http://localhost:8000/mcp"
      }
    }
  }
}

Install in Windsurf

Windsurf supports HTTP MCP servers directly. Add to your Windsurf configuration:

{
  "mcpServers": {
    "minime": {
      "url": "http://localhost:8000/mcp",
      "transport": "http"
    }
  }
}

Note: If you changed HOST_MCP_PORT in minime.env from the default 8000, update the URL in your IDE config (e.g., http://localhost:8001/mcp).

npm Setup (For Command-Only IDEs)

These IDEs require the npm client as a bridge because they don't support HTTP MCP servers with localhost URLs:

Claude Desktop
Zed
JetBrains IDEs
Cline
BoltAI
Other command-only IDEs

Step 1: Install npm Client

npm install -g @minimemcp/mcp-client

Install in Claude Desktop

Step 1: Locate Claude Desktop Config File

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Step 2: Add Recallium MiniMe Configuration

{
  "mcpServers": {
    "minime": {
      "command": "/bin/sh",
      "args": [
        "-c",
        "PATH=/opt/homebrew/bin:/opt/homebrew/opt/node@22/bin:/usr/local/bin:/usr/bin:$PATH npx -y minime-mcp"
      ],
      "env": {
        "MINIME_SERVER_URL": "http://localhost:8000/mcp",
        "MINIME_DEBUG": "false"
      }
    }
  }
}

Important notes:

Set MINIME_DEBUG to "true" only for troubleshooting
Adjust the PATH to match your Node.js installation location
The -y flag ensures npx always uses the latest published version

Step 3: Enable Recallium MiniMe Tools

Save the config and restart Claude Desktop
Go to Connectors → Minime
Enable each tool you want to use

Step 4: Verify Connection

Check Claude Desktop logs for successful connection
Try using a Recallium MiniMe tool (e.g., get_rules with project_name: "__global__")

Install in JetBrains IDEs

Configure JetBrains IDEs (IntelliJ IDEA, WebStorm, PyCharm, etc.) to use the npm client:

{
  "mcpServers": {
    "minime": {
      "command": "npx",
      "args": ["-y", "minime-mcp"],
      "env": {
        "MINIME_SERVER_URL": "http://localhost:8000/mcp"
      }
    }
  }
}

Configuration

The minime.env file contains all configuration options. Key settings:

Database (Required)

POSTGRES_PASSWORD=minime_password  # Change in production!

LLM Provider

# Default: Ollama (free, local)
LLM_PROVIDER=ollama
LLM_MODEL=qwen2.5-coder:7b

# Or use OpenAI
# LLM_PROVIDER=openai
# LLM_MODEL=gpt-4o
# OPENAI_API_KEY=sk-...

# Or use Anthropic
# LLM_PROVIDER=anthropic
# LLM_MODEL=claude-sonnet-4-5-20250929
# ANTHROPIC_API_KEY=sk-ant-...

Ports (Host Mappings)

HOST_UI_PORT=9000        # Access UI on your machine
HOST_MCP_PORT=8000       # Access MCP API on your machine
HOST_POSTGRES_PORT=5432  # Access PostgreSQL on your machine

# Container internal ports are fixed (not configurable):
# MCP:8000, UI:9000, DB:5432

See minime.env for all available options with detailed inline documentation.

After Editing Configuration

After editing minime.env, restart the container:

cd install
docker compose down
docker compose --env-file minime.env up -d

Management Commands

# View logs
docker compose --env-file minime.env logs -f

# Stop
docker compose down

# Restart
docker compose --env-file minime.env restart

# Update to latest version
docker compose --env-file minime.env pull
docker compose --env-file minime.env up -d

# Reset everything (⚠️ deletes all data!)
docker compose down -v

Troubleshooting

Ollama Connection Issues

# Ensure Ollama is running
ollama serve

# Verify models are downloaded
ollama list

# Test Ollama connection
curl http://localhost:11434/api/version

If Ollama is running on a different host:

# Edit install/minime.env
OLLAMA_HOST=http://your-ollama-host:11434

Port Conflicts

Edit minime.env and change the HOST_* port mappings, then restart:

# Edit install/minime.env - change HOST_UI_PORT, HOST_MCP_PORT, etc.
docker compose down
docker compose --env-file minime.env up -d

Remember: If you change HOST_MCP_PORT, you must also update your IDE config to use the new port.

Claude Desktop HTTP 406 Errors

If you see "HTTP 406: Not Acceptable" errors in Claude Desktop logs:

Update npm client to latest version:
```
npm install -g @minimemcp/mcp-client
```

Clear npx cache:

rm -rf ~/.npm/_npx
npm cache clean --force

Restart Claude Desktop completely

The latest npm client (v1.2.3+) includes the correct Accept headers required by the Recallium MiniMe server.

Tools Not Appearing in IDE

Verify Docker container is running:
```
docker ps -f name=minimemcp
```

Check MCP server health:

curl http://localhost:8000/health
curl http://localhost:8000/mcp/status

For HTTP-capable IDEs (Cursor, VS Code):
- Verify URL ends with /mcp: http://localhost:8000/mcp
- Restart your IDE after config changes
For command-only IDEs (Claude Desktop, Zed):
- Ensure npm client is installed: npm list -g @minimemcp/mcp-client
- Check MINIME_SERVER_URL includes /mcp: http://localhost:8000/mcp

View Container Status

# Check container status
docker ps -f name=minimemcp

# View all logs
docker logs -f minimemcp

# Check health endpoint
curl http://localhost:8000/health

# Check MCP status with tool list
curl http://localhost:8000/mcp/status

Next Steps

Now that Recallium MiniMe Community Edition is installed:

Install MiniMe in 5 Minutes

What is Recallium MiniMe?

Prerequisites

1. Docker

2. Ollama (for free local AI)

Quick Start

Step 1: Clone the Repository

Step 2: Optional - Configure Ports (Before Starting)

Step 3: Start Recallium MiniMe

HTTP Setup (Recommended - No npm Client)

Install in Cursor

Install in VS Code

Install in Windsurf

npm Setup (For Command-Only IDEs)

Step 1: Install npm Client

Install in Claude Desktop

Install in JetBrains IDEs

Configuration

Database (Required)

LLM Provider

Ports (Host Mappings)

After Editing Configuration

Management Commands

Troubleshooting

Ollama Connection Issues

Port Conflicts

Claude Desktop HTTP 406 Errors

Tools Not Appearing in IDE

View Container Status

Next Steps

Quick Start Guide

Concepts Guide

Search Guide

Performance Benchmarks

Install MiniMe in 5 Minutes

What is Recallium MiniMe?

Prerequisites

1. Docker

2. Ollama (for free local AI)

Quick Start

Step 1: Clone the Repository

Step 2: Optional - Configure Ports (Before Starting)

Step 3: Start Recallium MiniMe

HTTP Setup (Recommended - No npm Client)

Install in Cursor

Install in VS Code

Install in Windsurf

npm Setup (For Command-Only IDEs)

Step 1: Install npm Client

Install in Claude Desktop

Install in JetBrains IDEs

Configuration

Database (Required)

LLM Provider

Ports (Host Mappings)

After Editing Configuration

Management Commands

Troubleshooting

Ollama Connection Issues

Port Conflicts

Claude Desktop HTTP 406 Errors

Tools Not Appearing in IDE

View Container Status

Next Steps

Quick Start Guide

Concepts Guide

Search Guide

Performance Benchmarks

Related Resources

Documentation

Product Pages

Support