MCP server for Reflect Notes - connect your notes to Claude Desktop. Just run: npx reflect-mcp
npm install reflect-mcpConnect your Reflect notes to Claude Desktop.
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
1. Install the reflect-mcp package:
``bash`
npm install reflect-mcp
2. Install the server:
`bash`
npx reflect-mcp install
3. Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
`json`
{
"mcpServers": {
"reflect": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:3000/mcp"]
}
}
}
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.
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 "
`bash`
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
| Option | Description | Default |
|--------|-------------|---------|
| db-path | Path to Reflect SQLite database | ~/Library/Application Support/Reflect/File System/000/t/00/00000000 |--port
| | Server port | 3000 |
`bashInstall with default settings
npx reflect-mcp install
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 noteTroubleshooting
Server won't start
- Check if port 3000 is available:
lsof -i :3000
- Try a different port: npx reflect-mcp install --port 4000OAuth 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 installDatabase 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`MIT