マークダウンファイルからobsidianタスクを抽出およびクエリするためのモデルコンテキストプロトコル(MCP)サーバー。 MCP プロトコルを介して Claude と連携し、AI によるタスク管理を実現します。

##特徴

• Obsidian のマークダウンファイルからタスクを抽出し、Obsidian タスク プラグインと互換性のある形式
• 完了と終了タスクを識別
• タスクメタデータにアクセスする:
• ステータス(完全/不完全)
• 期限
• 予定日
• 開始日
• 作成された日付
• タグ
• 優先順位
• 再発ルール

ツール

MCP サーバーでは、以下のツールを提供しています。

リスト all tasks

ディレクトリ内のマークダウンファイルからすべてのタスクを抽出し、サブフォルダから再帰的にスキャンします。

入力パラメータ:

• [path] (文字列、オプション): マークダウンファイルをスキャンするディレクトリ。 指定されていない場合、最初の許可されたディレクトリにデフォルト値を指定します。

返品: タスクオブジェクトの JSON 配列, それぞれを含む:

クエリ tasks

Obsidian タスク クエリの構文に基づいてタスクを検索します。 マッチングタスクを見つけるために複数のフィルタを適用します。

入力パラメータ:

• [path] (文字列、オプション): マークダウンファイルをスキャンするディレクトリ。 指定されていない場合、最初の許可されたディレクトリにデフォルト値を指定します.

Obsidian Tasks MCP Server

A Model Context Protocol (MCP) server for extracting and querying Obsidian Tasks from markdown files. Designed to work with Claude via the MCP protocol to enable AI-assisted task management.

Features

• Extract tasks from Obsidian markdown files with a format compatible with the Obsidian Tasks plugin
• Identify completed and pending tasks
• Access task metadata including:
  • Status (complete/incomplete)
  • Due dates
  • Scheduled dates
  • Start dates
  • Created dates
  • Tags
  • Priority
  • Recurrence rules

Tools

This MCP server provides the following tools:

list_all_tasks

Extracts all tasks from markdown files in a directory, recursively scanning through subfolders.

Input Parameters:

• path (string, optional): The directory to scan for markdown files. If not specified, defaults to the first allowed directory.

Returns: A JSON array of task objects, each containing:

{
  "id": "string",          // Unique identifier (filepath:linenumber)
  "description": "string", // Full text description of the task
  "status": "complete" | "incomplete", // Task completion status
  "filePath": "string",    // Path to the file containing the task
  "lineNumber": "number",  // Line number in the file
  "tags": ["string"],      // Array of tags found in the task
  "dueDate": "string",     // Optional - YYYY-MM-DD format 
  "scheduledDate": "string", // Optional - YYYY-MM-DD format
  "startDate": "string",   // Optional - YYYY-MM-DD format
  "createdDate": "string", // Optional - YYYY-MM-DD format
  "priority": "string",    // Optional - "high", "medium", or "low"
  "recurrence": "string"   // Optional - recurrence rule
}

query_tasks

Searches for tasks based on Obsidian Tasks query syntax. Applies multiple filters to find matching tasks.

Input Parameters:

• path (string, optional): The directory to scan for markdown files. If not specified, defaults to the first allowed directory.
• query (string, required): The query string using Obsidian Tasks query syntax. Each line is treated as a filter.

Returns: A JSON array of task objects that match the query, with the same structure as list_all_tasks.

Supported Query Syntax:

• Status filters:

  • done - Show completed tasks
  • not done - Show incomplete tasks

• Date filters (due):

  • Note on semantics: due today is an exact match (only tasks due exactly today). Use range operators to include earlier/later dates.
  • due today - Tasks due today
  • due before today - Tasks due before today (exclusive)
  • due after today - Tasks due after today (exclusive)
  • due on or before today - Tasks due today or earlier (inclusive)
  • due on or after today - Tasks due today or later (inclusive)
  • due on YYYY-MM-DD or due YYYY-MM-DD - Tasks due on a specific date