Skip to main content
Glama
MikolajSapek

vaultcraft MCP server

by MikolajSapek

vaultcraft MCP server

Optional companion server for the vaultcraft plugin. The plugin works without it. It is bundled only with the ChatGPT and Codex directory version, and anyone can add it to another MCP client.

Endpoint: https://vaultcraft.sapcorp.eu/mcp (Streamable HTTP, no sign-in).

Tools

All three tools only compute and return a result. They are marked read-only, non-destructive and closed-world, and they never write anywhere.

Tool

What it returns

get_vault_config

The .obsidian settings for a new studies, work, research or personal vault: graph colours per folder, hover previews, core plugins, and the callout and concept-card CSS snippets.

get_note_template

The vaultcraft Markdown template for a concept, lecture, detailed lecture, lab or bridge note.

check_vault

A report on notes passed in: broken [[wikilinks]] with a suggested fix, notes nothing links to, concept notes without a definition or example, definitions too long for the hover preview, and lectures that do not list their concepts.

Related MCP server: Obsidian MCP Second Brain Server

Data

Notes sent to check_vault are processed in memory for that one request and then discarded. The server keeps no database, writes no files and does not log request bodies. See PRIVACY.md.

Run it

npm ci
npm test          # starts the server and checks every tool over HTTP
npm start         # http://localhost:8787/mcp

Add it to Claude Code:

claude mcp add --transport http vaultcraft https://vaultcraft.sapcorp.eu/mcp

Deploy

The container runs next to an existing Cloudflare tunnel (docker-compose.yml, network n8n_default). No host port is published. OPENAI_APPS_CHALLENGE in .env serves the OpenAI domain-verification token at /.well-known/openai-apps-challenge.

After changing the templates in vaultcraft, run scripts/sync-templates.sh ../vaultcraft.

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    Not graded
    maintenance
    Enables AI assistants like Claude to read, search, create, and manage notes in Obsidian vaults, with features for link analysis, tag management, daily notes, templates, and optional Google Calendar integration. Provides comprehensive vault operations including batch updates, backlinks discovery, and secure file management with path traversal protection.
    31
    1
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables read-only access to Obsidian vaults with semantic search, tag filtering, and metadata queries. Provides secure, intelligent note retrieval and summarization for LLMs without modifying your vault.
    12 npm
    13
    ISC