Obsidian Tasks MCP Server

@jfim

About Obsidian Tasks MCP Server

Obsidian tasks MCP server

#obsidian #tasks #mcp #task-management #ai-assistant

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "obsidian-tasks-mcp": {
      "command": "npx",
      "args": [
        "@jfim/obsidian-tasks-mcp",
        "/path/to/obsidian/vault"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Obsidian Tasks MCP Server?

A Model Context Protocol (MCP) server that extracts and queries tasks from Obsidian markdown files using the Obsidian Tasks plugin format. Designed to enable AI-assisted task management with Claude via the MCP protocol.

How to use Obsidian Tasks MCP Server?

Install globally via npm (npm install -g @jfim/obsidian-tasks-mcp) or run directly with npx. Specify the path to your Obsidian vault as a command-line argument when starting the server. Add the server configuration to your MCP-supporting client (e.g., Claude Desktop) using the JSON configuration shown in the README.

Key features of Obsidian Tasks MCP Server

Extracts tasks from Obsidian markdown files recursively through subfolders.
Provides two tools: list_all_tasks and query_tasks.
Supports metadata: status, due/scheduled/start/created dates, tags, priority, recurrence.
Fully compatible with Obsidian Tasks emoji and Dataview task formats.
Includes a query_tasks tool with rich filter syntax (status, dates, tags, path, description, priority).

Use cases of Obsidian Tasks MCP Server

List all tasks from an entire Obsidian vault to get an overview.
Filter tasks by due date to find overdue or upcoming items.
Query incomplete tasks with specific tags for project management.
Search tasks by priority to focus on high‑priority work.

FAQ from Obsidian Tasks MCP Server

What task formats does Obsidian Tasks MCP Server support?

The server supports both Obsidian Tasks emoji format (e.g., 🗓️, ⏳, 📅) and Dataview format for task metadata.

How do I run the server without installing globally?

Use npx @jfim/obsidian-tasks-mcp /path/to/obsidian/vault. No installation required.

What query syntax does the `query_tasks` tool accept?

It uses Obsidian Tasks query syntax. Filters include done/not done, date operators (e.g., due today, due before YYYY-MM-DD), tag filters (tag includes #tag), path filters, description filters, and priority filters.

Can I use this server with Docker?

Yes. Build the Docker image from the repository and run with a bind mount to your vault. Example configuration for Claude Desktop is included.

Is there a test suite included?

Yes. Run npm test to execute the test suite. See TESTING.md for more details.

Frequently asked questions

What task formats does Obsidian Tasks MCP Server support?

The server supports both Obsidian Tasks emoji format (e.g., `🗓️`, `⏳`, `📅`) and Dataview format for task metadata.

How do I run the server without installing globally?

Use `npx @jfim/obsidian-tasks-mcp /path/to/obsidian/vault`. No installation required.

What query syntax does the `query_tasks` tool accept?

It uses Obsidian Tasks query syntax. Filters include `done`/`not done`, date operators (e.g., `due today`, `due before YYYY-MM-DD`), tag filters (`tag includes #tag`), path filters, description filters, and priority filters.

Can I use this server with Docker?

Yes. Build the Docker image from the repository and run with a bind mount to your vault. Example configuration for Claude Desktop is included.

Is there a test suite included?

Yes. Run `npm test` to execute the test suite. See `TESTING.md` for more details.

Comments

Basic information

More Memory & Knowledge MCP servers

The Cloud

Teka

The Cloud is the AI-native workspace that gives every AI — Claude, ChatGPT, Gemini, and other Frontier & Free or Local models — shared memory and real agents. Not cloud computing: thecloud.so is one workspace where your

Rust Docs MCP Server

Govcraft

🦀 Prevents outdated Rust code suggestions from AI assistants. This MCP server fetches current crate docs, uses embeddings/LLMs, and provides accurate context via a tool call.

286