🧠 Nemo — MCP Server

Turn your AI conversations into a structured, searchable knowledge base.

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

📁 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 knowledge is stored, categorized, and searchable forever.

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)

🚀 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 reminder for next Friday to review the PR"
   • "Bookmark this link: https://..."

Claude Desktop (Local)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "nemo": {
      "command": "node",
      "args": ["/path/to/nemo-mcp/dist/index.js"],
      "env": {
        "TRANSPORT": "stdio",
        "STORAGE_TYPE": "supabase",
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SERVICE_KEY": "your-service-role-key"
      }
    }
  }
}

🔗 Webhooks — Connect to Make, Zapier, n8n

Nemo can send events to external services whenever something happens. This lets you build automations like:

• Save to Notion — Every new knowledge entry creates a page in your Notion database
• Google Calendar — New reminders automatically create calendar events
• Slack notifications — Get pinged when you save something important
• Google Sheets — Log all bookmarks to a spreadsheet
• Email digest — Trigger a daily summary via n8n

Quick Setup with Make

1. In Make, create a new scenario with a Webhook trigger
2. Copy the webhook URL (e.g. https://hook.eu2.make.com/abc123...)
3. Add it to your .env:

   WEBHOOK_URL=https://hook.eu2.make.com/abc123...
   

4. Restart the MCP server
5. Now every time you save something via Claude, Make receives the event

Webhook Events

Payload Format

Every webhook receives a JSON POST with this structure:

{
  "event": "knowledge.saved",
  "timestamp": "2025-03-15T14:30:00.000Z",
  "data": {
    "id": "uuid-here",
    "title": "Docker multi-stage builds",
    "category": "devops",
    "tags": ["docker", "ci-cd"],
    "content_preview": "First 300 characters...",
    "source": "claude-chat"
  }
}

Multiple Webhooks

You can send different events to different services:

WEBHOOKS_JSON='[
  {
    "url": "https://hook.eu2.make.com/xxx",
    "events": ["knowledge.saved", "bookmark.saved"],
    "name": "Make - Notion sync"
  },
  {
    "url": "https://hooks.zapier.com/yyy",
    "events": ["reminder.created"],
    "name": "Zapier - Google Calendar"
  },
  {
    "url": "https://n8n.yourdomain.com/webhook/zzz",
    "events": ["*"],
    "name": "n8n - Log everything"
  }
]'

Security

Add a shared secret for HMAC signature verification:

WEBHOOK_SECRET=your-secret-here

Each request includes an X-Nemo-Signature header with a sha256= HMAC of the payload body. Verify this in your automation to ensure the request comes from your Nemo server.

📱 Future Ideas

• Flutter app to browse your knowledge base (connects directly to Supabase)
• Vector search with pgvector for semantic "find things similar to..."
• Image storage via Supabase Storage
• Export to Markdown/Obsidian
• Daily digest of reminders via email

🛠️ Development

# Install dependencies
npm install

# Development mode (auto-reload)
npm run dev

# Build for production
npm run build

# Run tests (coming soon)
npm test

📄 License

MIT — Use it, fork it, make it yours.