Markdown

You can run a dedicated MCP server that exposes an HTTP API to manage your Obsidian Vault and Markdown files. It gives you vault statistics, note access, link extraction, daily notes, advanced search, TODO management, and file operations all via simple API calls you can integrate into your workflows.

How to use

Start by running the server locally and use an MCP client to interact with the exposed HTTP endpoints. You can perform operations such as generating vault statistics, listing notes, extracting links and TODOs, creating daily notes, and performing content searches. All actions are available through the HTTP API, so you can script common tasks or plug them into your editor/automation stack.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system. You will run the server from your project directory after installing dependencies.

# Install dependencies
npm install

# Start the server
npm start

Configuration and usage notes

Default server URL is http://localhost:8080. You can customize the port and vault path using environment variables.

Environment variables you can set before starting the server:

export BASE_PATH="/path/to/your/obsidian/vault"
export PORT=8080
npm start

Troubleshooting and tips

If the server does not start, verify that the requested BASE_PATH exists and that PORT is not in use by another process. Check that dependencies installed correctly with npm install. If you change BASE_PATH or PORT, restart the server for the changes to take effect.

Available tools

generateVaultStats

Generate vault statistics including total notes, size, word count, link count, and more.

getAllTags

Retrieve a list of all tags used across notes.

getRecentlyModifiedNotes

Fetch notes sorted by most recent modification within a specified window.

getRecentlyCreatedNotes

Fetch notes sorted by creation date within a specified window.

extractTodos

Extract TODO items from all notes, filterable by status.

extractLinks

Extract internal and external links, embeds, and tags from notes.

createDailyNote

Create a new daily note for a given date or the current date.

listFiles

List files under a directory with optional recursive search.

searchContent

Search note contents by text, keywords, or patterns.

manageFrontmatter

Read and update Frontmatter metadata in Markdown files.