Skip to content
MCP server

Datanotes

Turns a folder of Markdown notes into typed, validated tables for agents

Runs locallyStatus and history
Install
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 datanotes

Add to claude_desktop_config.json

{
  "mcpServers": {
    "datanotes": {
      "command": "npx",
      "args": [
        "-y",
        "datanotes"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "datanotes": {
      "command": "npx",
      "args": [
        "-y",
        "datanotes"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP 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
  4. Local-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
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity