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

Basic information

Category

Memory & Knowledge

Runtime

node

Transports

stdio

Publisher

jfim

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.

Comments

More Memory & Knowledge MCP servers

Jupyter Notebook MCP Server (for Cursor)

jbeno

Model Context Protocol (MCP) server designed to allow AI agents within Cursor to interact with Jupyter Notebook (.ipynb) files

157

Context Portal MCP (ConPort)

GreatScottyMac

Context Portal (ConPort): A memory bank MCP server building a project-specific knowledge graph to supercharge AI assistants. Enables powerful Retrieval Augmented Generation (RAG) for context-aware development in your IDE.

763

JupyterMCP - Jupyter Notebook Model Context Protocol Integration

jjsantos01

A Model Context Protocol (MCP) for Jupyter Notebook

130

Ultimate Google Docs & Drive MCP Server

a-bonus

The Ultimate Google Docs, Sheets, Drive, Gmail, & Google Calendar MCP Server. This MCP (primarily for use in Claude Desktop) gains full access to your google suite and lets claude do its thing.

605

Notion MCP Server

suekou

A Model Context Protocol server for connecting Notion to MCP-compatible clients

910