# Markdown Task Extractor MCP

> Markdown Task Extractor scans local directories, pulling every open and completed to-do item from any Markdown note. Whether you use Obsidian, Logseq, or Notion exports, this MCP treats your entire file vault as one centralized task list. It processes hundreds of files in milliseconds, giving your AI client a complete picture of what needs doing across all your projects.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** task-tracking, markdown, glob-pattern, todo-list, note-taking, task-aggregation

## Description

Your notes aren't organized in one place; they're scattered across dozens of daily journals and project folders. If you ask an agent to find your pending tasks without this MCP, it fails because it can't read those local files. This connector solves that problem by scanning a specified folder path. It pulls every task marked with `- [ ]` or `- [x]` from all the Markdown notes within, regardless of how old or where they sit on your computer. The result is a clean, structured list that you feed directly into your AI chat context. With Vinkius managing this MCP in their catalog, you connect once and gain access to powerful file processing like this. You stop copying task lists from five different files just to ask one question about your overall workload.

## Tools

### extract_markdown_todos
Scans a local directory path to extract every open and completed task marked in Markdown files, listing the file source for context.

## Prompt Examples

**Prompt:** 
```
Scan my Obsidian vault at C:/Notes and list all my pending tasks grouped by file.
```

**Response:** 
```
I found 12 pending tasks across 4 different files. Here is the grouped breakdown:
```

**Prompt:** 
```
Look through my Notion exports folder and tell me how many tasks I completed this week.
```

**Response:** 
```
Based on the `- [x]` markers, you have completed exactly 24 tasks.
```

**Prompt:** 
```
Find all tasks in my project folder that contain the hashtag '#urgent'.
```

**Response:** 
```
I found 3 open tasks marked with #urgent:
1. Fix database deployment (backend.md)
2. Call investor (meetings.md)
```

## Capabilities

### Aggregate Tasks From Folders
Scans a specified directory path, pulling all open and completed tasks marked in Markdown notes.

### Identify Task Statuses
Distinguishes between pending items (open) and completed items using standard markdown syntax.

### Handle Large Volumes of Files
Uses fast file globbing patterns to read thousands of local Markdown files quickly, providing high-speed context feeding.

## Use Cases

### Project Retrospective
A PM needs to know what was supposed to happen on a feature launch that spanned three months. They ask their agent to scan the entire project folder, and the MCP provides a list of all pending tasks marked up over time, allowing them to pinpoint missed steps.

### Weekly Planning
A technical writer has finished drafting several guides into different folders. They use the MCP to consolidate every single action item and follow-up thought from the entire directory so they can plan their next week's writing schedule.

### Deep Research Review
A student has collected articles and notes across multiple local folders for a thesis. Instead of manually tracking progress, they use the MCP to gather all research tasks into one list and ask their agent which ones need immediate attention.

### Bug Tracking Review
A developer needs to review every reported issue across several sprint folders. The MCP pulls out all action items, letting them quickly see the status of every bug fix without reading hundreds of comments.

## Benefits

- Stop hunting through files. This MCP pulls every task, open or closed, into one place so your agent can analyze your full workload instantly.
- It doesn't just read text; it understands Markdown syntax. It correctly differentiates between pending tasks (`- [ ]`) and finished items (`- [x]`).
- The speed is insane. Using fast glob patterns, you process hundreds of files in milliseconds—you won't wait for your agent to load the context.
- You don't have to manually list file paths or worry about syntax. Just point the MCP at your notes folder and get a clean task dump.
- It works with standard note-taking systems, including Obsidian vaults, Notion exports, and Logseq files.

## How It Works

The bottom line is you get a single, structured data dump containing every to-do item from all the Markdown files in your specified folder.

1. Provide the MCP with the absolute directory path containing all your raw Markdown notes.
2. The system scans every file in that folder, extracting only lines that match the standard task syntax (`- [ ]` or `- [x]`).
3. Your AI client receives a consolidated text block: one complete list of tasks from across your entire local vault.

## Frequently Asked Questions

**Can Markdown Task Extractor read tasks from PDF files?**
No, this MCP only scans Markdown (`.md`) files. It relies on the specific markdown syntax used in those text files; it cannot process non-text documents like PDFs.

**What file types does extract_markdown_todos support?**
It supports any local directory containing Markdown files, including those exported from apps like Obsidian, Logseq, and Notion.

**How fast is this MCP?**
It uses advanced glob patterns to scan large directories extremely quickly, processing hundreds of files in milliseconds. You don't have to wait long for context loading.

**Does Markdown Task Extractor handle completed tasks?**
Yes, it distinguishes between open and closed items. It extracts both pending (`- [ ]`) and completed (`- [x]`) tasks, giving you a full history.

**Do I need to write custom code to use this MCP?**
No. You just connect your preferred AI client to the Vinkius catalog and tell it the local folder path. The agent handles the rest.