Tracks git commits across multiple repositories and syncs notes via git.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@better-notes Get my daily summary for yesterday"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A personal knowledge management system designed for daily journaling, meeting notes, and capturing ideas. Built with MCP (Model Context Protocol) integration for Claude, full-text search, git sync, and git activity tracking across your projects.
Use it to:
Capture daily notes, meeting summaries, and ideas through Claude conversations
Track mentions of people (@hannah) and topics (#project) automatically
Search across all your notes with natural language queries
Monitor git activity across multiple repositories
Generate daily summaries combining notes and code commits
MCP Integration: Use Claude to create, search, and manage notes naturally
Full-Text Search: SQLite-powered search across all notes
Git Auto-Sync: Automatic commits and pushes with smart debouncing
Git Activity Tracking: Monitor commits across multiple repositories
Daily Summaries: Generate summaries combining notes and git activity
Entity Extraction: Automatically tracks @mentions for people
Background Daemon: File watching and syncing runs in the background
Human-Readable Storage: Markdown files organized by date
Related MCP server: Vault MCP Server
npm install -g @better-notes/cliInitialize:
better-notes initStart the daemon (optional, for file watching and git sync):
better-notes daemon startAdd to Claude Code (one-liner):
claude mcp add-json better-notes '{"command":"npx","args":["@better-notes/cli","serve"]}' --scope userOr if globally installed:
claude mcp add-json better-notes '{"command":"better-notes","args":["serve"]}' --scope userNote: The
--scope userflag makes the MCP server available globally across all projects. Omit it for project-local configuration.
Or configure Claude Desktop manually:
{
"mcpServers": {
"better-notes": {
"command": "better-notes",
"args": ["serve"]
}
}
}# Interactive setup
better-notes init
# Show configuration
better-notes config# Start background daemon
better-notes daemon start
# Stop daemon
better-notes daemon stop
# Check status
better-notes daemon status
# Run in foreground
better-notes daemon start --foreground# Create a note
better-notes note create --title "Meeting with team" --content "Discussed roadmap"
# View today's note
better-notes note today
# List recent notes
better-notes note recent --days 7# Full-text search
better-notes search "project timeline"
# Search with filters
better-notes search "@hannah past week"# Rebuild search index
better-notes index rebuild
# Show index stats
better-notes index stats# Manually sync notes with git (pull, commit, push)
better-notes sync# List tracked git projects
better-notes projects --list
# Scan a directory and select repos to track
better-notes projects --add ~/Projects
# Interactively remove tracked projects
better-notes projects --remove# View git commits across tracked projects for today
better-notes changes
# View git commits for a specific date
better-notes changes --date 2026-01-15
# Create a daily summary note (notes + git activity)
better-notes summarize
# Summarize a specific date
better-notes summarize --date 2026-01-15# Show instructions for systemd/launchd
better-notes install-serviceWhen used with Claude, the following tools are available:
Tool | Description |
| Create a new note entry |
| Append to today's note |
| Natural language search with filters |
| Find notes mentioning a person |
| Full-text topic search |
| Get summary for a day |
| List notes from past N days |
| Get full note content |
| List available categories |
| List all tags |
| List mentioned people |
| Filter by category |
| Filter by tag |
| View git commits across tracked projects |
| Generate a daily summary with notes and git activity |
Notes are stored in markdown format:
~/notes/
├── 2026/
│ ├── 01/
│ │ ├── 2026-01-15.md
│ │ └── 2026-01-16.md
│ └── 02/
│ └── ...
├── .index/
│ ├── notes.db # SQLite search index
│ ├── daemon.pid # Daemon PID file
│ └── daemon.log # Daemon log
└── .gitignoreNotes use YAML frontmatter:
---
title: Notes for 2026-01-15
created: 2026-01-15T09:00:00.000Z
updated: 2026-01-15T14:30:00.000Z
tags:
- project
- meeting
mentions:
- hannah
- bob
---
## 09:00 - Morning standup
Discussed sprint progress with @hannah and @bob.
Tags: #meeting #standup
## 14:30 - Project review
Reviewed Q1 roadmap. Key decisions:
- Launch feature X by Feb
- Prioritize performance work
Tags: #project #planningConfig file: ~/.better-notes.json
{
"notesDirectory": "~/notes",
"categories": ["work", "meeting", "personal", "idea", "task"],
"defaultCategory": "personal",
"gitSync": {
"enabled": true,
"debounceSeconds": 30,
"autoCommit": true,
"autoPush": true
},
"daemon": {
"enabled": true,
"watchFiles": true
},
"search": {
"enableEntityExtraction": true,
"maxResults": 20
},
"gitProjects": [
{ "name": "my-app", "path": "~/Projects/my-app" },
{ "name": "api-server", "path": "~/Projects/api-server" }
]
}MIT
This server cannot be deployed
Personal knowledge base MCP server with semantic search, auto-categorization, metadata extraction
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
