Obsidian Tasks MCP

Example Use Cases

• 1

  Discover and list all tasks across an Obsidian vault (including metadata like due dates, tags, priority, and recurrence) without parsing markdown themselves.

• 2

  Run Obsidian Tasks–style queries (status, date filters, tags, path, description, priority) to find matching tasks and return structured JSON results.

• 3

  Integrate task data into workflows or assistants via MCP (e.g., Claude) or run the server locally via npm/npx or Docker for private vault access.

Description

This MCP server scans an Obsidian vault (or other markdown directory) to extract tasks in the Obsidian Tasks plugin format and exposes them over the Model Context Protocol. It parses task status, dates (due, scheduled, start, created), tags, priority, and recurrence and supports querying with Obsidian Tasks–style filters. The tool is designed to be run locally (via npm, npx, node, or Docker) and integrates with Claude or other MCP-capable agents to enable automated task discovery and filtered queries. It helps agents reason about and manage tasks without needing to parse markdown themselves.