TaskForge 3.0: Your Obsidian Tasks, Now Readable by Any AI Agent
TaskForge is a task manager that keeps every task as a line in a markdown file on your own disk, in your Obsidian vault or any folder, instead of in someone else's database. Version 3.0 lets any AI agent read and write those files through a new MCP server and command line, adds a full Windows app, and redesigns the interface from the dock up.
what's overdue?
- query_tasks { "overdue": true }
- renew the passport Jun 9
- submit the expense report Yesterday
- book flights Today
- Three tasks, read straight from your own files.
Get Free - iOS & Mac 
Get Free - Android What makes 3.0 the biggest TaskForge release?
What 3.0 changes is who else gets to read your tasks. Every task TaskForge manages is a line in a markdown file you own, in your Obsidian vault or any folder you point it at. Most task managers keep your list in their database and rent you a view of it; this release goes the other way and hands the file to your tools. An MCP server and a command-line tool ship in 3.0, so Claude, Cursor, or any agent that can run a command can list your overdue work, add a task, or reschedule one, straight on your own disk. Windows becomes a real platform in the same release, widgets learned about sections, notes are editable without leaving the app, and the whole interface got a redesign.
How do AI agents read and write your Obsidian tasks?
Through an MCP server, using the Model Context Protocol that Claude and Cursor already speak. Point Claude Desktop, Claude Code, or Cursor at it and ask what's overdue: the agent calls query_tasks, reads the markdown files in your vault, and answers. Ask it to add a task and it writes a line in the same syntax you would have typed. A command-line tool does the same job from a terminal or a shell script.
Install taskforge-md through npm/npx with Node.js, or download a native binary or .mcpb bundle. The server reads your vault directly without an Obsidian plugin. Your AI client may send tool inputs and results to its provider; its privacy settings still apply.
What's new in TaskForge widgets?
Space widgets now show every section of a space rather than just its tasks, so a space that mixes tasks and calendar events shows both on your home screen. There is a new XL size for the widgets that earn the room, plus two new tiles: one for today's daily note, and one for the calendar.
Tapping a task in a widget still completes it in place, and the file on disk changes at that moment. Widgets remain the fastest way to use TaskForge without opening TaskForge. Our guide to Obsidian widgets covers the full set; this is what 3.0 added to them.
TaskForge widgets for Obsidian The full Obsidian widgets guide
Can I use TaskForge on Windows?
Yes, as of 3.0. There is a signed Windows installer you download straight from this site, with no store account in the way. It is the same app as the Mac build, reading the same markdown files, so a workspace on OneDrive or a synced folder opens on either machine.
Windows is also where the command line and MCP server feel most at home, since both are desktop tools. If your vault lives on a PC, in OneDrive or a synced folder, this is the release that closes the gap: the same files open on the Windows app and the Mac one, with no export step.
What is the vault agent contract?
It is a pair of files TaskForge writes into your workspace: agents.md and dialect.json, describing your exact task format with worked examples. Open your vault as a project in Claude Code or Cursor and they read agents.md the way they read a CLAUDE.md or .cursor/rules file.
It exists because an agent that can edit files still has to guess what your tasks look like. Does a due date use an emoji or a field? Is priority a symbol or a word? agents.md answers in your own dialect, down to a worked line like `- [ ] call the plumber 📅 2026-06-13 ⏫`, so the agent writes something your app reads back. The files regenerate when your settings change, so they cannot drift from what the app expects.
What changed in the redesign?
The floating + button is gone. In its place there is a dock, and one omnibar that searches and creates in the same field: start typing to filter what you are looking at, or keep typing to make a new task out of what you typed. Type today to jump to today's note.
Surfaces are true black or true white now, cards separate with a one-pixel edge instead of a shadow, and the accent colour is mint. If you are upgrading from 2.7, a one-time guide walks through what moved, and you can replay it later from settings.
Can I edit notes without leaving TaskForge?
You can. Browse the notes in your workspace, open one, and edit it in place, with a markdown toolbar for bold, headers, and links, plus full undo. Lists continue themselves as you type. Daily notes work in every workspace now, whether or not you use Obsidian, and you can create today's note from your own template.
Open a note, edit it, and the change is on disk the moment you stop typing. Tasks and the notes around them used to mean two apps. Now they are one screen.
What happened to my lists?
Lists are called spaces now. Yours carried over automatically the first time you opened 3.0, filters and all.
What is new is what a space can hold. Instead of one list of tasks, a space stacks named sections, each with its own filter, and those sections can be tasks or calendar events. A space called This Week can hold an overdue section, a today section, and your meetings, in the order you want to read them.
What's free in 3.0 that used to cost money?
Three things. You can choose which task details show, like priority, tags, and dates, and which quick actions appear when you long-press a task. Priorities can be renamed too, with colours you pick yourself.
These were small enough that gating them mostly annoyed people who had not paid yet. Premium still covers unlimited custom spaces, widgets, kanban, creating calendar events, and custom notifications.
What else is in 3.0?
Bulk editing, so you can complete, reschedule, or retag a whole selection at once. Quick filter now narrows the calendar grid and your notes, not just task lists. Quick Add understands spelled-out dates like in two days. Tapping a tag, context, or project inside a task shows everything else that matches it. The month view can show one-line previews instead of dots. Restoring a deleted task puts it back in its original file and position. Plus a long list of fixes, including a rare bug that could drop a task whose tags were packed together with no spaces.
Read every change in 3.0Get TaskForge 3.0
Free to download on iPhone, iPad, Mac, Android, and Windows. Your tasks stay in your own files, on your own device.
Related Articles
- How to Manage Obsidian Tasks with AI (Claude, ChatGPT, MCP) The practical guide to pointing an AI agent at your task files, and what it can do once it is there. Read more
- Obsidian Widgets on Your Home Screen Check off a task without unlocking your phone, and watch the markdown file change. Read more
- The Complete Obsidian Tasks Syntax Guide Every symbol explained: due dates, priorities, recurrence, and tags, with copy-paste examples. Read more
