Nemo MCP Server

Nemo — MCP Server

Turn your AI conversations into structured, searchable notes.

An MCP (Model Context Protocol) server that lets you save notes, conversation takeaways, ideas, code snippets, bookmarks, and reminders directly from Claude, ChatGPT, or any MCP-compatible AI assistant.

Disclaimer

This project is experimental and is not ready for production use.

The MCP endpoint is not secured yet: authentication and authorization are not implemented, so access is not protected by default. Do not expose this server publicly as-is.

Before using it in production, you should at minimum add authentication, access control, proper secret management, rate limiting, and basic security hardening around the HTTP endpoint.

Repository Layout

• src/ — Runtime server code
• db/ — Public database schema and migrations
• docs/ — Product-facing public docs
• notes/ — Public work-in-progress notes, mockups, and experiments

What It Does

You're chatting with Claude on your phone and the conversation is brilliant. Instead of losing it, you say:

"Save this in Nemo under DevOps, tag it docker and kubernetes"

Claude calls your MCP server, and your note is stored, categorized, and searchable later.

Available Tools

Two Deployment Options

Option A: Supabase (Recommended)

Best if you want a managed database with a free tier, REST API for future apps (Flutter, web), and zero database maintenance.

Your Phone → Claude App → Your VPS (MCP Server) → Supabase Cloud (PostgreSQL)

Option B: Self-Hosted (Docker)

Best if you want full data ownership, everything on your VPS, no external dependencies.

Your Phone → Claude App → Your VPS (Docker: MCP Server + PostgreSQL)

Search Language

Full-text search for notes is configured in French by default.

If most of your notes are in another language, update the text search config so it matches your target language in db/schema.sql, db/migrations/003_add_notes_search_vector.sql, src/services/supabase-adapter.ts, and src/services/postgres-adapter.ts.

Quick Start — Option A: Supabase

1. Create a Supabase Project

1. Go to supabase.com and create a free project
2. Go to SQL Editor and run the contents of db/schema.sql
3. Go to Settings → API and copy your:
   • Project URL (e.g., https://abc123.supabase.co)
   • Service Role Key (keep this secret!)

2. Deploy on Your VPS

# Clone the repo
git clone https://github.com/gabriellangon/nemo-mcp.git
cd nemo-mcp

# Install dependencies
npm install

# Build
npm run build

# Configure
cp .env.example .env
# Edit .env with your Supabase credentials:
#   STORAGE_TYPE=supabase
#   SUPABASE_URL=https://your-project.supabase.co
#   SUPABASE_SERVICE_KEY=your-service-role-key

# Test it
node dist/index.js
# Should see: Nemo MCP server running on http://0.0.0.0:3100/mcp

3. Keep It Running with pm2

npm install -g pm2
pm2 start dist/index.js --name nemo-mcp
pm2 save
pm2 startup  # Auto-start on reboot

4. Set Up HTTPS with Nginx

# Install certbot if not already done
sudo apt install certbot python3-certbot-nginx

# Get SSL certificate
sudo certbot --nginx -d nemo.yourdomain.com

# Copy nginx config
sudo cp nginx.conf /etc/nginx/sites-available/nemo-mcp
# Edit the domain name in the file
sudo ln -s /etc/nginx/sites-available/nemo-mcp /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

Quick Start — Option B: Self-Hosted (Docker)

# Clone the repo
git clone https://github.com/gabriellangon/nemo-mcp.git
cd nemo-mcp

# Configure
cp .env.example .env
# Edit .env:
#   STORAGE_TYPE=postgres
#   DB_PASSWORD=your-secure-password

# Launch everything
docker compose up -d

# Check logs
docker compose logs -f mcp

Then set up nginx + HTTPS the same way as Option A.

Connect to Claude

Claude.ai (Web & Mobile)

1. Go to Settings → Integrations → MCP
2. Add a new integration:
   • URL: https://nemo.yourdomain.com/mcp
3. Start chatting and say things like:
   • "Save this conversation in my brain under the category 'devops'"
   • "What did I save about Docker?"
   • *"Add a remind