MCP.so
登录

Obsidian Tasks MCP Server

@jfim

关于 Obsidian Tasks MCP Server

Obsidian tasks MCP server

基本信息

分类

记忆与知识

运行时

node

传输方式

stdio

发布者

jfim

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.

评论

记忆与知识 分类下的更多 MCP 服务器