Obsidian Tasks MCP

🚀 Obsidian Tasks MCP Server

このサーバーは、Go言語で実装された独立したMCPサーバーです。Obsidianのボールト内のMarkdownファイルからタスクを解析し、REST APIに依存することなく、Obsidian Tasksプラグインのクエリフィルターを評価します。

このサーバーは、Obsidian Tasksプラグインのクエリフィルターの一部を実装しています。完全なクエリ構文と使用例については、Tasksプラグインのドキュメントを参照してください。

🚀 クイックスタート

このサーバーを使うことで、Obsidianのタスク管理をより柔軟に行うことができます。以下に、インストール方法と使用例を紹介します。

📦 インストール

最新バージョンをインストールするには、以下のコマンドを実行します。

go install github.com/hairyhenderson/obsidian-tasks-mcp@latest

または、ソースコードからインストールすることもできます。

git clone https://github.com/hairyhenderson/obsidian-tasks-mcp.git
cd obsidian-tasks-mcp
go install .

💻 使用例

基本的な使用法

サーバーは標準入出力を介して動作し、MCPプロトコルを使用して通信します。コマンドライン引数として1つ以上のルートディレクトリを指定します。

obsidian-tasks-mcp -root /path/to/vault -root /path/to/other/vault

高度な使用法

サーバーは、単一のMCPツール query_tasks を提供します。このツールは以下の引数を受け取ります。

• query (文字列、オプション): フィルター付きのタスククエリ文字列（1行に1つのフィルター）。サポートされているフィルターと構文については、Tasksプラグインのクエリドキュメントを参照してください。
• rootDirs (文字列の配列、必須): Markdownファイルをスキャンするルートディレクトリ

このツールは、id、description、status、filePath、lineNumber、tags、および dueDate フィールドを持つタスクオブジェクトの配列を返します。

Cursorの設定

CursorのMCP設定（通常は ~/.cursor/mcp.json など）に以下を追加します。

{
  "mcpServers": {
    "obsidian-tasks": {
      "command": "obsidian-tasks-mcp",
      "args": [
        "-root",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

複数のルートディレクトリを指定することもできます。

{
  "mcpServers": {
    "obsidian-tasks": {
      "command": "obsidian-tasks-mcp",
      "args": [
        "-root",
        "/path/to/vault1",
        "-root",
        "/path/to/vault2"
      ]
    }
  }
}

🔧 技術詳細

開発

テストを実行するには、以下のコマンドを実行します。

make test

リントを実行するには、以下のコマンドを実行します。

make lint

📄 ライセンス

このプロジェクトは、MITライセンスの下でライセンスされています。完全なライセンステキストについては、LICENSEファイルを参照してください。

Copyright (c) 2026 Dave Henderson