JO

jfim/obsidian-tasks-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

15 stars 14 forks Качество 57 Тренд 21

Обсидиан задачи MCP сервера

Обзор

Сервер Model Context Protocol (MCP) для извлечения и запроса задач Obsidian из файлов разметки. Предназначен для работы с Клодом через протокол MCP, чтобы обеспечить управление задачами с помощью ИИ. - Извлекать задачи из файлов разметки Obsidian с форматом, совместимым с плагином Obsidian Tasks - Идентифицировать завершенные и отложенные задачи - метаданные задачи доступа, включая: - Статус (полный/неполный) - Даты выполнения - Запланированные даты - Даты запуска - Созданные даты - Теги - Приоритет - Правила повторения Этот MCP-сервер предоставляет следующие инструменты: Извлекает все задачи из файлов разметки в каталоге, рекурсивно сканируя через подпапки. - путь (струна, факультативно): Каталог для сканирования файлов разметки. Если не указано, по умолчанию в первом разрешенном каталоге. Массив задач JSON, каждый из которых содержит: Поиск задач на основе синтаксиса запросов Obsidian Tasks. Применяет несколько фильтров для поиска соответствующих задач. - путь (струна, факультативно): Каталог для сканирования файлов разметки.

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP) для извлечения и запроса задач Obsidian из файлов разметки. Предназначен для работы с Клодом через протокол MCP, чтобы обеспечить управление задачами с помощью ИИ.

Особенности

  • Извлечение задач из файлов разметки Obsidian с форматом, совместимым с плагином Obsidian Tasks Определить завершенные и ожидающие задачи
  • метаданные задач доступа, включая: Статус (полный/неполный)
  • Сроки сдачи
  • Запланированные даты
  • Даты начала.
  • Созданные даты
  • Тэги
  • Приоритет
  • Правила повторения

Инструменты

Этот MCP-сервер предоставляет следующие инструменты:

list all tasks

Извлекает все задачи из файлов разметки в каталоге, рекурсивно сканируя через подпапки.

** Параметры ввода:**

  • [[Т0]] (струна, факультативно): Каталог для сканирования файлов разметки. Если не указано, по умолчанию в первом разрешенном каталоге.

** Возврат:** Массив задач JSON, каждый из которых содержит:

Запрос задачи

Поиск задач на основе синтаксиса запросов Obsidian Tasks. Применяет несколько фильтров для поиска соответствующих задач.

** Параметры ввода:**

  • [[Т1]] (струна, факультативно): Каталог для сканирования файлов разметки. Если не указано, по умолчанию в первом разрешенном каталоге.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

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
Открыть полный README на GitHub

Установка

npx @jfim/obsidian-tasks-mcp /path/to/obsidian/vault
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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