Notes MCP Server

An MCP (Model Context Protocol) server for saving project notes and design decisions to a SQLite database. Designed to be used across multiple projects with git-tracked storage.

Features

• Persistent Storage: Notes are saved to a SQLite database that can be committed to git
• Project Organization: Group notes by project name
• Categories: Organize notes as design decisions, architecture notes, requirements, todos, bugs, ideas, or documentation
• Tagging: Add tags for flexible categorization
• Search: Full-text search across titles and content
• Markdown Support: Content supports markdown formatting

Installation

cd ~/mcp/notes-mcp-server
npm install
npm run build

Configuration

Add to your Claude Desktop or Claude Code MCP configuration:

{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["/home/aaronbalentine/mcp/notes-mcp-server/dist/index.js"],
      "env": {
        "NOTES_DB_PATH": "/path/to/your/project/.notes/notes.db"
      }
    }
  }
}

The NOTES_DB_PATH environment variable specifies where the SQLite database is stored. Set this to a path inside your project directory to track notes with git.

Tools

notes_add

Create a new note for a project.

project: string      - Project name
category: string     - design_decision|architecture|requirement|todo|bug|idea|documentation|general
title: string        - Brief title
content: string      - Full content (markdown supported)
tags: string[]       - Optional tags

notes_get

Retrieve a specific note by ID.

notes_update

Update an existing note (partial updates supported).

notes_delete

Delete a note permanently.

notes_search

Search and filter notes with pagination.

project: string      - Filter by project
category: string     - Filter by category
query: string        - Search in title/content
tags: string[]       - Filter by any matching tag
limit: number        - Max results (default 20)
offset: number       - Pagination offset

notes_list_projects

List all projects that have notes.

notes_stats

Get statistics about stored notes.

Git Tracking

To track notes in your project:

1. Add .notes/ to your project
2. Set NOTES_DB_PATH to point to <project>/.notes/notes.db
3. Commit the .notes/notes.db file

Note: SQLite in WAL mode creates -wal and -shm files. Add these to .gitignore:

.notes/*-wal
.notes/*-shm

Development

# Development with auto-reload
npm run dev

# Build for production
npm run build

# Run built version
npm start