MCP.so
Sign In

Obsidian Tasks MCP Server

@jfim

Repository

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

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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

Category

Memory & Knowledge

Transports

stdio

Author

jfim

More Memory & Knowledge MCP servers

Dash Api Docs Mcp Server

Kapeli

MCP server for Dash, the macOS API documentation browser

167

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

Memory

modelcontextprotocol

Model Context Protocol Servers

88.1K

Notion MCP Server

awkoy

Notion MCP server for Claude, Cursor, ChatGPT & Claude Desktop. Connect AI agents to Notion via Model Context Protocol — pages, databases, blocks, comments, files.

159

Docs MCP Server

arabold

Grounded Docs MCP Server: Open-Source Alternative to Context7, Nia, and Ref.Tools

1.5K