@datacore-one/mcp

A plain-text second brain for AI assistants — journal, knowledge, and productivity tools over MCP.

Why

AI assistants are great at reasoning but have nowhere to put what matters: your decisions, your notes, your day.

Datacore gives them a structured, plain-text second brain — capture journal entries and knowledge notes, search them back, get canonical date handling, and extend with modules (GTD, health, trading, and more).

Persistent memory — engrams, learning, and recall — is handled by Datacore's companion server, PLUR (plur_* tools). Run the two side by side: PLUR remembers, Datacore organizes.

Not a RAG system. Not a vector database you have to manage. Just plain-text files and an MCP server.

Quick Start

Install globally:

npm install -g @datacore-one/mcp

Then connect from any MCP-compatible client. On first use, the server creates ~/Datacore/ with:

• journal/ — Daily session logs
• knowledge/ — Ingested reference material
• engrams.yaml — Shared engram store, read and written by the companion PLUR MCP
• packs/ — Engram packs used by PLUR
• config.yaml — Configuration (all fields optional)
• CLAUDE.md, AGENTS.md, .cursorrules, .github/copilot-instructions.md — Editor context files so any AI assistant immediately understands Datacore

Everything is plain text -- no databases, no lock-in.

Connecting

Datacore is a standard MCP server. It works with any client that speaks MCP v1.0+ over stdio or HTTP -- the AI model behind the client does not matter.

Claude Code

Add to .mcp.json in your project root (or ~/.claude.json globally):

{
  "mcpServers": {
    "datacore": {
      "command": "datacore-mcp"
    }
  }
}

Then allow Datacore tools in .claude/settings.json (or .claude/settings.local.json):

{
  "permissions": {
    "allow": [
      "mcp__datacore"
    ]
  },
  "enableAllProjectMcpServers": true
}

This auto-approves all Datacore MCP tools (capture, search, status, etc.) so you don't get prompted on every call. The enableAllProjectMcpServers setting ensures the MCP server defined in .mcp.json is activated automatically.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "datacore": {
      "command": "datacore-mcp"
    }
  }
}

Cursor / Windsurf / Other MCP Clients

Most MCP-compatible editors use the same config format. Check your editor's MCP documentation for where to place the server config. The command is always datacore-mcp.

HTTP (Remote / Multi-Client)

For shared or remote setups, run in HTTP mode:

datacore-mcp --http

Then point your MCP client to http://127.0.0.1:3100/mcp. See HTTP Transport for options.

Two Modes

| Mode | Storage | What You Get | |------|---------|--------------| | Core (~/Datacore) | Flat files | Journal, knowledge, dates, packs | | Full (~/Data) | Datacore system | + modules, GTD, spaces, Datacortex |

Mode is auto-detected. If you have a full Datacore installation at ~/Data, it uses that. Otherwise it creates a lightweight ~/Datacore directory.

Override with environment variables: DATACORE_PATH (full) or DATACORE_CORE_PATH (core).

Tools (5 core + 3 full-mode)

Datacore exposes productivity tools. Memory — engrams, learning, recall, packs — is provided by the companion PLUR MCP server (plur_* tools), not by Datacore.

Core

| Tool | Description | |------|-------------| | datacore_capture | Write a journal entry or knowledge note | | datacore_search | Search journal and knowledge by keyword or semantic | | datacore_ingest | Ingest text as a knowledge note | | datacore_status | System status, counts, actionable recommendations | | datacore_date | Canonical date operations (today, day-of-week, validate, add/sub, parse, org-stamp) |

Modules (full mode only)

| Tool | Description | |------|-------------| | datacore_modules_list | List installed modules | | datacore_modules_info | Detailed info about a module | | datacore_modules_health | Health check for modules |

Tool names use underscores to satisfy the MCP tool-name rule ^[a-zA-Z0-9_-]{1,64}$. Legacy dot-namespaced names (datacore.capture) are still accepted as aliases for backward compatibility.

Prompts

The server provides MCP prompts — workflow templates your AI can discover and use automatically:

| Prompt | Description | |--------|-------------| | datacore-capture | Capture a journal entry or knowledge note | | datacore-guide | Complete guide to Datacore tools and workflows |

Prompts are the primary way the AI understands Datacore. When your AI connects, it can list available prompts and immediately knows how to capture, search, and organize — and that persistent memory lives in PLUR.

Resources

| Resource | Description | |----------|-------------| | datacore://guide | Agent workflow reference (markdown) | | datacore://status | System status summary (JSON) | | datacore://journal/today | Today's journal entry (markdown) | | datacore://journal/{date} | Journal entry by date |

Memory (via PLUR)

Datacore organizes; PLUR remembers.

Persistent memory — engrams, learning, recall, feedback, and engram packs — lives in the companion PLUR MCP server (plur_* tools). Datacore scaffolds the shared, plain-text data directory (including engrams.yaml and packs/) that PLUR reads and writes, so both servers work against the same ~/Data or ~/Datacore store.

Connect both in your MCP client and your AI gets a second brain (Datacore) plus persistent memory (PLUR). See the PLUR docs for the memory toolset and engram lifecycle.

Upgrading from ≤1.5? The engram engine (learn, inject, recall, promote, feedback, forget, packs, and the engagement/XP layer) moved out of Datacore into PLUR. Install @plur-ai/mcp alongside Datacore to keep that functionality.

Configuration

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | DATACORE_PATH | ~/Data | Full installation path | | DATACORE_CORE_PATH | ~/Datacore | Core mode storage path | | DATACORE_TIMEZONE | System | IANA timezone (e.g., Europe/Ljubljana) | | DATACORE_LOG_LEVEL | warning | debug, info, warning, error | | DATACORE_CACHE_TTL | 60 | File cache TTL in seconds | | DATACORE_TRANSPORT | stdio | stdio or http | | DATACORE_HTTP_PORT | 3100 | HTTP transport port | | DATACORE_HTTP_HOST | 127.0.0.1 | HTTP bind address |

config.yaml

Create config.yaml in your Datacore directory (or .datacore/config.yaml in full mode):

version: 2
search:
  max_results: 20
  snippet_length: 500        # chars around match
hints:
  enabled: true              # include _hints in tool responses for agent guidance

All fields have defaults -- the file is optional. Memory-related settings (engrams, packs, engagement) are configured in PLUR, not here.

HTTP Transport

For remote or multi-client setups:

DATACORE_HTTP_PORT=8080 datacore-mcp --http

• MCP endpoint: POST /mcp
• Health check: GET /health
• Default bind: 127.0.0.1:3100

Module System (Full Mode)

Full Datacore installations extend the MCP server with module-provided tools. Modules are discovered from .datacore/modules/ and space-scoped directories. Each module can register its own tools under the datacore_[module]_[tool] namespace.

License

MIT