Reflect MCP Server

Connect your Reflect notes to Claude Desktop.

Prerequisites

Before installing, make sure you have:

• Reflect Desktop - Must be installed (but does not need to be running)

  • Download from reflect.app

• Claude Desktop - Required to use MCP servers

  • Download from claude.ai

• Node.js - Version 18 or higher recommended

  • Download from nodejs.org

Quick Start

1. Install the reflect-mcp package:

npm install reflect-mcp

2. Install the server:

npx reflect-mcp install

3. Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "reflect": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "--port", "4209", "http://localhost:3000/mcp"]
    }
  }
}

Important:

• Make sure the port number (3000 in the example above) matches the port you used when installing the server. If you installed with a custom port using --port, use that port number instead.
• Add "--port", "4209" (use a different port number for each MCP client - e.g., "4210", "4211", etc.) to avoid port conflicts. Each MCP client needs a unique port.

4. Restart Claude Desktop

That's it! First time you use a Reflect tool, your browser will open to authenticate.

Note: If you see auth errors, try restarting Claude Desktop one more time.

Usage Examples

Once installed, you can ask Claude to read and write your notes:

• "Read all my notes tagged #spanish and create a study guide note with my biggest gaps"

• "Read my last 3 daily notes and create a weekly summary note tagged #reflection"

• "Look at notes tagged #work. Create a 'Career Development Plan' note based on what I'm learning and struggling with"

• "Read my 1:1 meeting notes with [[manager]] and create a performance review prep note "

Commands

reflect-mcp install [db-path]    # Install as auto-start service
reflect-mcp uninstall            # Remove auto-start service
reflect-mcp status               # Check service status
reflect-mcp [db-path]            # Run server manually

Options

Option	Description	Default
db-path	Path to Reflect SQLite database	~/Library/Application Support/Reflect/File System/000/t/00/00000000
--port <port>	Server port	3000

Examples

# Install with default settings
npx reflect-mcp install

# Install with custom database path
npx reflect-mcp install ~/custom/path/to/reflect/db

# Install with custom port
npx reflect-mcp install --port 4000

# Check if service is running
npx reflect-mcp status

# Remove auto-start
npx reflect-mcp uninstall

Tools Available

• get_graphs - List all Reflect graphs
• get_backlinks - Get backlinks for a note
• get_daily_notes - Get recent daily notes
• get_daily_note_by_date - Get daily note for specific date
• get_backlinked_notes - Get notes with most backlinks
• get_tags - Get all tags with usage counts
• get_notes_with_tag - Get notes with a specific tag
• get_note - Get a note by title
• create_note - Create a new note

Troubleshooting

Server won't start

• Check if port 3000 is available: lsof -i :3000
• Try a different port: npx reflect-mcp install --port 4000

OAuth not working

• Restart Claude Desktop after installation
• Check server is running: npx reflect-mcp status
• Try uninstalling and reinstalling: npx reflect-mcp uninstall && npx reflect-mcp install

Database not found

• Ensure Reflect Desktop is installed
• Verify database path exists at default location
• Try specifying custom path: npx reflect-mcp install /path/to/db

Demo:

https://www.loom.com/share/455b1d3eb7184bdea1ae4e8d5904fc53

License

MIT