# Markdown Task Extractor MCP for AI Agents AI Agent Connect

> Markdown Task Extractor scans your local folders to pull every '- [ ]' and '- [x]' item from your Obsidian, Logseq, or Notion notes into a single list. It turns scattered notes into a clear to-do list for your AI client instantly.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_TC6bOol4dM9F6UvOcxTE11ZuKARP5UlI4JTgKBbK/ai-agent-connect
- **Tags:** task-tracking, markdown, glob-pattern, todo-list, note-taking, task-aggregation

## Description

This Connector lets you turn a messy vault of notes into a single, actionable to-do list. If you use Obsidian, Logseq, or Notion, your tasks are likely scattered across dozens of different daily notes and project files. When you ask your AI what's next on your plate, it often hits a wall because it can't see into your local files effectively. This tool solves that by using a fast-glob pattern to scan hundreds of local .md files in milliseconds. It grabs every pending and completed task, along with the specific file it came from, and feeds it directly into your AI chat context. It's a way to give your agent a bird's-eye view of your entire workload without you having to copy and paste anything. You can find this in the Vinkius marketplace to get your local notes synced with your chat. It makes your notes searchable and actionable in a way that feels like the AI actually knows your life.

## Tools

### extract_markdown_todos
The extract_markdown_todos tool scans a local directory of Markdown files and pulls out every open and completed task. It tells your AI exactly which file each task is in.

## 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:

**Project Alpha**
- Fix database deployment (backend.md)
- Call investor (meetings.md)

**Personal**
- Buy groceries (daily_log.md)
- Call mom (daily_log.md)
```

**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)
3. Update documentation (docs.md)
```

## Capabilities

### Pull all open tasks
Get a list of every pending - [ ] item across your entire folder.

### Track completed work
See every - [x] task you've already finished.

### Map tasks to files
Know exactly which note a specific to-do belongs to.

### Scan huge folders
Process hundreds of files in a fraction of a second.

### Filter by status
Distinguish between what's done and what's still on your plate.

## Use Cases

### Where did I leave off?
A writer asks for pending tasks in a specific project folder to see what's left to write.

### Weekly Review
A user asks to see all completed tasks from the last month to see what they actually got done.

### Urgent Check
Someone asks for all tasks containing #urgent across their entire note system.

### Daily Planning
A student asks for all open tasks in their Semester 1 folder to plan their day.

## Benefits

- No more manual copying: You don't have to copy tasks from one file to another to show your AI what's next.
- Instant vault awareness: Your AI can see tasks across hundreds of files in under 50ms.
- Keep files organized: You can leave your notes exactly where they are while the Connector handles the aggregation.
- Accurate status tracking: The AI knows the difference between a done task and a pending one using the - [x] and - [ ] markers.
- Zero setup friction: You just point the AI to your folder and it works immediately.

## How It Works

The bottom line is your AI gets a real-time map of every task hidden in your local notes.

1. Provide the absolute path to your notes folder.
2. The Connector scans every Markdown file using fast-glob.
3. You get a structured list of all tasks ready for your AI to act on.

## Frequently Asked Questions

**Does Markdown Task Extractor work with my Obsidian vault?**
Yes, it works perfectly with Obsidian. It scans your local folder for any Markdown files and pulls out the tasks for your AI to see.

**Can I use this for Logseq notes?**
Yes, it's designed to work with Logseq, Notion exports, and any other Markdown-based note-taking system.

**Will it show my completed tasks too?**
It will. It identifies both - [ ] for open tasks and - [x] for completed ones, so you can see your full history.

**Do I have to move my notes to a special folder?**
No, you don't. You just need to provide the absolute path to your current notes folder.

**Is it fast enough for large vaults?**
Yes, it uses a fast-glob pattern to scan hundreds of files in milliseconds.

**Does it work with Notion?**
It works with local exports from Notion. If your notes are stored as local Markdown files, this Connector can read them.

**Does it work with massive Obsidian vaults?**
Yes! It uses an optimized `fast-glob` engine that can recursively scan thousands of nested folders and markdown files almost instantly without crashing.

**Will this tool accidentally modify my notes?**
No. This engine operates in strict read-only mode. It uses regex to extract the text and returns it to the AI context. Your files are never altered.

**Does it capture task due dates or tags?**
The parser grabs the entire line containing the `- [ ]` markdown syntax. Any tags (like #urgent) or dates written on that same line will be captured and visible to the AI.