Taskforge
Local MCP server for tasks and notes in a Markdown folder or Obsidian vault
- Pricing
- Freemium
- Platforms
- macOS, Windows, CLI
- Runs
- Locally
- Version
- 1.1.0
- Listing updated
- 3 days ago
About Taskforge
Taskforge is a freemium MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Taskforge runs as a subcommand of the taskforge binary (taskforge mcp --stdio) and works directly on the Markdown files in a vault folder, the same files the Taskforge app edits. Nothing is hosted: you point the server at a folder with the TASKFORGE_VAULT environment variable and it needs no account or API key.
The site says it exposes 47 tools covering the task and note lifecycle: create, read, update, complete, archive and delete with bulk variants, moving and reparenting tasks, converting between an inline line and a task file, renaming notes without breaking links, a lint check before writing, and a vault health check. It prefers MCP over the CLI when an agent already has a connection, because the tools are typed and return structured errors an agent can correct against.
Install with npx, or on Claude Desktop with a one-click .mcpb bundle for macOS, Windows or Linux. Claude Code and Codex are configured with a short command or a config.toml entry. ChatGPT cannot reach it, since that chat window only connects to internet-hosted servers.
Install
Run in a terminal
claude mcp add taskforge --env TASKFORGE_VAULT='<TASKFORGE_VAULT>' -- npx -y taskforge-mdAdd to claude_desktop_config.json
{
"mcpServers": {
"taskforge": {
"command": "npx",
"args": [
"-y",
"taskforge-md"
],
"env": {
"TASKFORGE_VAULT": "<TASKFORGE_VAULT>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"taskforge": {
"command": "npx",
"args": [
"-y",
"taskforge-md"
],
"env": {
"TASKFORGE_VAULT": "<TASKFORGE_VAULT>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"taskforge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"taskforge-md"
],
"env": {
"TASKFORGE_VAULT": "<TASKFORGE_VAULT>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"taskforge": {
"command": "npx",
"args": [
"-y",
"taskforge-md"
],
"env": {
"TASKFORGE_VAULT": "<TASKFORGE_VAULT>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"taskforge": {
"command": "npx",
"args": [
"-y",
"taskforge-md"
],
"env": {
"TASKFORGE_VAULT": "<TASKFORGE_VAULT>"
}
}
}
}Configuration
TASKFORGE_VAULTAbsolute path to the vault folder the server reads and writesRequired
What it does
- Local stdio server
- Runs on your machine and edits vault files directly, with no hosted service.
- 47 task and note tools
- Create, update, complete, archive, move and bulk-edit tasks, and manage notes.
- Link-safe note edits
- Notes can be renamed and edited without breaking links between them.
- Lint and doctor checks
- A lint check before writing a line and a vault health call.
- One-click Claude Desktop bundle
- A .mcpb bundle asks for your vault folder during setup.
- CLI with the same engine
- The CLI shares semantics with the MCP tools for scripts and CI.
Good for
- Let an agent add and complete tasks in an Obsidian vault
- Search and edit Markdown notes from Claude Code or Codex
- Bulk archive or move tasks across a vault
- Check vault health before an agent writes
- Convert inline task lines into task files
Pricing
Freemium, from $1.99 a month
App is free; Premium is $49.99 one-time, $19.99/year or $1.99/month
Prices change. Check taskforge.md before you buy.
Taskforge FAQ
Does it need an account or API key?
No. It runs locally over stdio and only needs the TASKFORGE_VAULT path.
Can I use it from ChatGPT?
Not directly. ChatGPT connects to hosted servers, and this one is local over stdio; the site points to Codex instead.
How do I install it on Windows?
Use cmd /c in front of npx in the client config, or the Windows .mcpb bundle for Claude Desktop.
Is the Taskforge app free?
The site says the app is free with an optional Premium purchase or subscription; the MCP server itself needs no account.
Is Taskforge free?
Taskforge has a free plan, with paid plans for more usage or features. Paid plans start at $1.99 a month.
How do I add Taskforge to Claude Code?
Run this command in your terminal: claude mcp add taskforge --env TASKFORGE_VAULT='<TASKFORGE_VAULT>' -- npx -y taskforge-md
What are the best alternatives to Taskforge?
The closest alternatives to Taskforge are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.
Alternatives to Taskforge

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools