Skip to content
MCP server

Taskforge

Local MCP server for tasks and notes in a Markdown folder or Obsidian vault

Runs locallyStatus and history
Install
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-md

Add 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

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP 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
  5. Local-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
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools