• UNSORTED
  • FILTERED
  • CONTEXT
  • HUMAN

How to aggregate markdown tasks with your AI

Connect this MCP to your AI client once. After that, your agent can crawl your local directories to find and organize every pending task.

Ask AI about this page

Short answer

How can I pull all my markdown checkboxes into one list?

Your AI uses the extractor to scan specific folders on your machine for markdown syntax. It finds every checkbox and presents them as a single, unified task list. You get a clear view of everything you need to do across multiple files.

Where every task lands.

The results of your scan.

Once the AI finishes reading your files, it organizes the findings into these categories.

UNSORTED

Raw task dump

The AI pulls every single checkbox it finds. This gives you a complete, unfiltered look at every pending item across all files.

FILTERED

Cleaned task lists

The AI removes duplicates and empty checkboxes. You get a list that only contains actual work items.

CONTEXT

File locations

Each task is paired with the file path where it lives. You'll know exactly which document to open to finish the job.

HUMAN

Manual review needed

The AI flags tasks that look incomplete or poorly formatted. You decide if they are actually actionable or just notes.

The workflow

What your AI does when you ask for a task scan.

The AI handles the heavy lifting of reading through your file system so you don't have to.

  1. Locate files

    The AI identifies all markdown files within the directory you specify.

    extract_markdown_todos

  2. Parse checkboxes

    The agent reads the content of those files to find specific markdown task syntax.

    extract_markdown_todos

  3. Map file paths

    The AI links every found task back to its original file location.

    extract_markdown_todos

  4. Consolidate list

    The agent gathers all individual items into a single, readable format for you.

    extract_markdown_todos

Try it

Copy these to start.

Use these prompts to trigger the extraction process.

Starting points

Swap out the folder names and file types to match your actual project structure.

Markdown Task Extractor Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_TC6bOol4dM9F6UvOcxTE11ZuKARP5UlI4JTgKBbK/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Markdown Task Extractor capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "markdown-task-extractor-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_TC6bOol4dM9F6UvOcxTE11ZuKARP5UlI4JTgKBbK/mcp"
    }
  }
}
Copy into chat04

  • Scan my /projects/work folder and list all the markdown tasks you find.

  • Find all the checkboxes in my notes.md file and group them by priority.

  • Look through my /docs directory and give me a unified list of every todo item.

  • Extract all the tasks from my current workspace and tell me which files they are in.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Markdown Task Extractor once, then ask.

Click the link to connect the MCP to your client. Your credentials stay encrypted, and you can start asking questions immediately.

Connect Markdown Task Extractor to your AI

FAQ

How this task behaves.

  • 01

    Can the AI edit my markdown files?

    No. The AI only reads the files to extract the tasks. It cannot change your content or delete any checkboxes.

  • 02

    Does it work with other file types like .txt or .org?

    No. This specific tool is built to find markdown-formatted checkboxes only.

  • 03

    Will it scan my entire hard drive?

    No. The AI only scans the specific folders or paths you tell it to look in.

  • 04

    Can it create new task files for me?

    No. The AI can only pull existing tasks out of your files into the chat.

  • 05

    How does it know which tasks are finished?

    It looks for the standard markdown checkbox syntax to distinguish between completed and pending items.

  • More questions about Markdown Task Extractor? The Connector page answers them. See everything the Markdown Task Extractor Connector can do

Connect Markdown Task Extractor to Claude, Cursor, ChatGPT & more