Nemo

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

Tool	Description
nemo_save_note	Save a conversation, idea, snippet, or note
nemo_search_notes	Search through your saved notes
nemo_get_note	Retrieve a specific note by ID
nemo_delete_note	Delete a note
nemo_list_categories	List all categories with counts
nemo_add_reminder	Add a reminder with due date and priority
nemo_list_reminders	List pending (or all) reminders
nemo_complete_reminder	Mark a reminder as done
nemo_save_bookmark	Save a URL with tags and description
nemo_search_bookmarks	Search through saved bookmarks
nemo_list_bookmarks	List bookmarks by category
nemo_stats	Dashboard with counts and categories

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 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 note 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

Event	Triggered when	Data included
note.saved	New note saved	id, title, category, tags, content_preview, source
note.deleted	Note deleted	id
reminder.created	New reminder added	id, title, due_date, priority, description
reminder.completed	Reminder marked as done	id
bookmark.saved	New bookmark saved	id, url, title, tags, category, description

Payload Format

Every webhook receives a JSON POST with this structure:

{
  "event": "note.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": ["note.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 notes (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.