tackle-mcp

Tackle MCP Server

MCP (Model Context Protocol) server for Tackle todo app, enabling LLMs to interact with your Tackle tasks and projects.

Features

• 9 Tackle Tools: Complete task and project management
• Secure Access: Restricted status updates (no "Done" marking via MCP)
• Rich Context: Project notes, directories, documents, and external resources
• Team Workflow: Task assignment to Tester role
• Cross-platform: macOS, Windows, Linux support
• Authentication: Secure token-based authentication

Installation

Prerequisites

• Node.js 18 or higher
• Tackle desktop app installed and run at least once
• Claude Code CLI

Quick Setup

• Generate Auth Token in Tackle App

  • Open Tackle app
  • Go to Settings (gear icon) → MCP Server
  • Click "Generate Token" and copy it

• Add to Claude Code

  claude mcp add tackle \
    -s user \
    -e TACKLE_AUTH_TOKEN=your_token_here \
    -- npx tackle-mcp@latest
  

• Test Connection

  claude "list my tackle tasks"
  

Database Locations

The MCP server automatically discovers your Tackle database:

• macOS: ~/Library/Application Support/Tackle/tackle.db
• Windows: %APPDATA%\Tackle\tackle.db
• Linux: ~/.config/tackle/tackle.db

You can override this with the TACKLE_DB_PATH environment variable:

claude mcp add tackle \
  -s user \
  -e TACKLE_AUTH_TOKEN=your_token \
  -e TACKLE_DB_PATH=/custom/path/database.db \
  -- npx tackle-mcp@latest

Available Commands

Once configured, you can use natural language with Claude Code or Gemini CLI:

• "List all my projects"
• "Show tasks in [project name]"
• "Create a task called 'Review PR' in the Development project"
• "Mark task X as completed"
• "Update the description of task Y"

MCP Tools

The server exposes 9 tools to Claude Code:

Core Task Management

• tackle_list_projects - List all projects with optional archived filter
• tackle_list_tasks - List/filter tasks by project, status, or search terms
• tackle_search_tasks - Search tasks by title or content
• tackle_create_task - Create new tasks with title, description, priority
• tackle_update_task - Update task details (title, description, etc.)
• tackle_delete_task - Delete tasks

Workflow & Status Management

• tackle_update_task_status - Update task status (restricted to: in_progress, for_review, blocked)
• tackle_assign_task - Assign tasks to Tester (only role allowed via MCP)

Project Context

• tackle_get_project_context - Get comprehensive project info including:
  • Project notes and description
  • Local directory path
  • Project documents
  • External resources/links
  • Project settings and theming

Security Features

• ❌ No "Done" Status: MCP cannot mark tasks as completed to prevent premature closure
• 🔒 Limited Assignment: Only "Tester" role assignment allowed
• 🛡️ Token Auth: Secure SHA-256 hashed authentication

Troubleshooting

"Database not found" error

• Ensure Tackle app is installed and has been run at least once
• Check the database exists at the expected location
• Use TACKLE_DB_PATH to specify custom location

"Invalid auth token" error

• Generate a new token in Tackle Settings → MCP Server
• Ensure you copied the entire token
• Check for extra spaces or quotes in your token

"MCP authentication not configured" error

• Enable MCP Server in Tackle Settings
• The app needs to create the auth tokens table first

Security

• Auth tokens are hashed with SHA-256 before storage
• Tokens are never logged or exposed
• Each token can be revoked from Tackle Settings
• Database access is limited to Tackle data only

Development

To run locally for development:

git clone https://github.com/ActionGround/tackle-mcp
cd tackle-mcp
npm install
npm start

License

MIT