Datanotes
Turns a folder of Markdown notes into typed, validated tables for agents
- Pricing
- Open source
- Platforms
- CLI, self-hosted, API
- Runs
- Locally
- Version
- 3.0.0
- Listing updated
- 2 days ago
About Datanotes
Datanotes is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Each note that carries a table property becomes a row, with its front matter keys as columns, while the file stays plain Markdown you can open in Obsidian, VS Code or git. A single metastore.yaml defines the columns. The engine checks types, links, unique values and CHECK rules, and a refused write changes nothing and explains how to fix the call.
Every write made through the engine is journaled with who made it (agent, session, token), so a change can be taken back with undo_migration, and with history turned on a table can be read as it was last week. Agents, programs and a phone can write at once; each write is checked against the latest data and applies whole or not at all. Hand edits are checked too and the engine reports what they break.
Beyond tables it offers joins, saved views, text and meaning-based search, link walking, git sync and an HTTP API with a JavaScript client. It runs locally on Node.js 22 or newer under Apache-2.0. The README says it is not a replacement for SQLite or Postgres: it is comfortable around 10,000 notes, and at 50,000 the first start takes about 15 seconds.
Install
Run in a terminal
claude mcp add datanotes -- npx -y datanotesAdd to claude_desktop_config.json
{
"mcpServers": {
"datanotes": {
"command": "npx",
"args": [
"-y",
"datanotes"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"datanotes": {
"command": "npx",
"args": [
"-y",
"datanotes"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"datanotes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"datanotes"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"datanotes": {
"command": "npx",
"args": [
"-y",
"datanotes"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"datanotes": {
"command": "npx",
"args": [
"-y",
"datanotes"
]
}
}
}Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- update_row
- Updates a row in a table and writes the change back to its note.
- undo_migration
- Takes back a change the engine journaled.
What it does
- Notes as tables
- Notes with a table property become rows; metastore.yaml defines the columns.
- Checked, atomic writes
- Types, links, unique values and CHECK rules are validated, and a bad write changes nothing.
- Journal and undo
- Writes are journaled with their author, and undo_migration reverses a change.
- Joins and views
- Filter, join and aggregate rows and save a query as a view.
- Search by text and meaning
- Search note text, find notes by meaning and walk links.
- Git sync
- Commits and pushes the vault, and a private repo can back up undo and history.
Good for
- Log things you watched or read and find them again later
- Keep linked tables like films, actors and viewings in plain notes
- Let several agents write to one vault without corrupting it
- Build a small app on top of an Obsidian vault over HTTP
Pricing
Open source
Apache-2.0, runs locally
Prices change. Check datanotes.dev before you buy.
Datanotes FAQ
Do my notes stop being Markdown?
No. Every row is still a note (or a section of a pack note) that you can read, edit, grep or commit.
Can I undo an agent's change?
Yes. The engine journals every write it makes and undo_migration takes a change back.
Is it a replacement for Postgres?
No. The README advises a classic database for large analytical data, high write throughput or many concurrent writers on one folder.
What does it need to run?
Node.js 22 or newer (24.16 or newer on Windows).
How do clients connect?
Run npx -y datanotes mcp --database your_database_folder, or add it to Claude Code, Claude Desktop, Cursor, VS Code or Codex.
Is Datanotes free?
Yes. Datanotes is open source, so you can use and self-host it for free.
How do I add Datanotes to Claude Code?
Run this command in your terminal: claude mcp add datanotes -- npx -y datanotes
What are the best alternatives to Datanotes?
The closest alternatives to Datanotes are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and Midplane.
Alternatives to Datanotes

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity