Advertise
MCP.so
Sign In

Obsidian Tasks MCP Server

@jfim

Repository

Basic information

Category

Memory & Knowledge

Transports

stdio

Author

jfim

About Obsidian Tasks MCP Server

Obsidian tasks MCP server

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

Obsidian Tasks MCP Server 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"
      ]
    }
  }
}

Obsidian Tasks MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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.

Frequently asked questions

1

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.

2

How do I run the server without installing globally?

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

3

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.

4

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.

5

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

Orcha

westonhancock

Orcha is a unified context layer for AI tools and agents. It stores and indexes and exposes organizational, team, or individual knowledge. Files, structured databases, and connected sources live in one workspace, and age

agentleFS

agentleFS

One permissioned folder your team and your AI agents both log into.

Groundwork

Rarefied-Earth

Groundwork: company memory for your AI tools. Docs public. Source closed. Public proof needs no account.

1

Sensefold

SenseFold Labs

Personal context for every AI: search, read, and write back to your private Markdown library of articles, threads, PDFs, notes, and captured ChatGPT/Claude/Gemini/Grok conversations. Remote server, OAuth 2.1 paste-and-au

Semantic Ui React

Semantic-Org

The official Semantic-UI-React integration

13.2K
Advertise