MCPgee
MCPgee
MCPgeeMCPgee

Taskfile

v1.0.0•Developer Tools•stable

Expose Taskfile tasks as MCP tools.

mcpmcp-servertaskfile
Share:
13
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Taskfile?

Taskfile is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to expose taskfile tasks as mcp tools.

Expose Taskfile tasks as MCP tools.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Expose Taskfile tasks as MCP tools.

Use Cases

Expose Taskfile automation tasks as MCP tools for AI execution.
Run task automation scripts through AI assistants.
rsclarke

Maintainer

LicenseMIT
Languagego
Versionv1.0.0
UpdatedMay 10, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx mcp-taskfile

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Taskfile

MCP Taskfile Server bridges Task (the Go-based task runner) and MCP-compatible AI assistants by dynamically exposing every task defined in a project's Taskfile as its own MCP tool with proper parameter schemas. The server watches for Taskfile changes and automatically reloads, supports multi-root workspaces and wildcard task patterns, and requires no API keys since it operates entirely on the local filesystem. Teams using Task for build automation, testing, or deployment scripts can let their AI assistant discover and execute those scripts through natural-language requests.

Prerequisites

  • Go 1.21+ installed (the server binary is installed via `go install`)
  • Task (taskfile.dev) installed and a Taskfile.yml present in your project directory
  • An MCP-compatible client such as Claude Desktop or Claude Code that supports MCP Roots
1

Install the mcp-taskfile-server binary

Use `go install` to download and build the server. The binary is placed in your $GOBIN directory (default: $GOPATH/bin).

go install github.com/rsclarke/mcp-taskfile-server@latest
2

Verify the binary is on your PATH

Confirm the server installed correctly and is accessible from your shell.

mcp-taskfile-server --version
3

Ensure your project has a Taskfile

The server looks for a Taskfile.yml (or Taskfile.yaml) in the project root. Each task defined there becomes an MCP tool. Create one if it does not exist yet.

# Example minimal Taskfile.yml
version: '3'
tasks:
  build:
    cmd: go build ./...
  test:
    cmd: go test ./...
4

Add the server to your MCP client configuration

Register mcp-taskfile-server in your claude_desktop_config.json. The server communicates over stdio and discovers your project root via the MCP Roots capability.

{
  "mcpServers": {
    "taskfile": {
      "type": "stdio",
      "command": "mcp-taskfile-server"
    }
  }
}
5

Optionally set the log level for debugging

Pass the MCP_TASKFILE_LOG_LEVEL environment variable to control logging verbosity. Useful when troubleshooting task discovery.

{
  "mcpServers": {
    "taskfile": {
      "type": "stdio",
      "command": "mcp-taskfile-server",
      "env": {
        "MCP_TASKFILE_LOG_LEVEL": "debug"
      }
    }
  }
}
6

Restart your MCP client and verify task discovery

Restart Claude Desktop or Claude Code. Ask the assistant to list available tools — each Taskfile task should appear as a separate MCP tool.

Taskfile Examples

Client configuration

Minimal claude_desktop_config.json entry to run the Taskfile MCP server with stdio transport.

{
  "mcpServers": {
    "taskfile": {
      "type": "stdio",
      "command": "mcp-taskfile-server",
      "env": {
        "MCP_TASKFILE_LOG_LEVEL": "info"
      }
    }
  }
}

Prompts to try

Example prompts once the Taskfile server exposes your project's tasks as MCP tools.

- "Run the build task for this project"
- "Execute the test task and show me the results"
- "What tasks are available in this project?"
- "Run the deploy task for the api service in the production environment"
- "Run the lint task and fix any issues you find"

Troubleshooting Taskfile

No tasks appear as MCP tools after connecting the server

The server looks for a Taskfile.yml in the project root discovered via MCP Roots. If your client does not support Roots, the server falls back to its working directory — make sure that directory contains your Taskfile.yml.

Binary not found after `go install`

Ensure $GOPATH/bin or $GOBIN is on your PATH. Run `export PATH="$(go env GOPATH)/bin:$PATH"` and add it to your shell profile. Alternatively, use the full absolute path in the MCP config command.

Wildcard tasks are not recognized

Wildcard tasks (e.g. deploy:*) appear with a required MATCH parameter as a JSON array. Pass the match segments as an array: {"MATCH": ["api", "production"]} to execute `task deploy:api:production`.

Frequently Asked Questions about Taskfile

What is Taskfile?

Taskfile is a Model Context Protocol (MCP) server that expose taskfile tasks as mcp tools. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Taskfile?

Follow the installation instructions on the Taskfile GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Taskfile?

Taskfile works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Taskfile free to use?

Yes, Taskfile is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Taskfile Alternatives — Similar Developer Tools Servers

Looking for alternatives to Taskfile? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "mcp-taskfile": { "command": "npx", "args": ["-y", "mcp-taskfile"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Taskfile?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides