{"_id":"@actionground/tackle-mcp","name":"@actionground/tackle-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@actionground/tackle-mcp","version":"0.1.0","description":"MCP server for Tackle - cross-platform task management","keywords":["mcp","model-context-protocol","tackle","todo","task-management"],"homepage":"https://github.com/ActionGround/tackle-mcp#readme","bugs":{"url":"https://github.com/ActionGround/tackle-mcp/issues"},"repository":{"type":"git","url":"git+https://github.com/ActionGround/tackle-mcp.git"},"license":"MIT","author":{"name":"actionground"},"type":"module","main":"index.js","bin":{"tackle-mcp":"index.js"},"directories":{"lib":"lib"},"scripts":{"start":"node index.js","dev":"node --watch index.js","lint":"echo 'No linter configured'"},"dependencies":{"better-sqlite3":"^11.10.0"},"engines":{"node":">=18.0.0"},"_id":"@actionground/tackle-mcp@0.1.0","gitHead":"711d35699cb204cec9c98dbcb5d68f9eaf9c1f7c","_nodeVersion":"24.4.1","_npmVersion":"11.4.2","dist":{"integrity":"sha512-G9v+iLoseU0XD368NK3Zco4roOJSXKcFHB3y8p2neHEbIOa2swQNXN9AeOMURyc+EZaaHWr961Su1sCMNL/P1Q==","shasum":"d636171fbdda442118b9b3bfe14aa1e98b97d510","tarball":"https://registry.npmjs.org/@actionground/tackle-mcp/-/tackle-mcp-0.1.0.tgz","fileCount":6,"unpackedSize":35801,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD+K1a+bu5Djo1xSDxYSYYRvmB7f6DCW/+BgCi8aLMU2gIhAKMfgvKjlxzDT6rTV78EoS8l1BPu5PGZhmWKQ2YlA4Qy"}]},"_npmUser":{"name":"actionground","email":"able.kl.ist@gmail.com"},"maintainers":[{"name":"actionground","email":"able.kl.ist@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tackle-mcp_0.1.0_1753226944346_0.1434492043649569"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-22T23:29:04.227Z","0.1.0":"2025-07-22T23:29:04.770Z","modified":"2025-07-22T23:29:05.080Z"},"maintainers":[{"name":"actionground","email":"able.kl.ist@gmail.com"}],"description":"MCP server for Tackle - cross-platform task management","homepage":"https://github.com/ActionGround/tackle-mcp#readme","keywords":["mcp","model-context-protocol","tackle","todo","task-management"],"repository":{"type":"git","url":"git+https://github.com/ActionGround/tackle-mcp.git"},"author":{"name":"actionground"},"bugs":{"url":"https://github.com/ActionGround/tackle-mcp/issues"},"license":"MIT","readme":"# Tackle MCP Server\n\nMCP (Model Context Protocol) server for Tackle todo app, enabling LLMs to interact with your Tackle tasks.\n\n## Features\n\n- List projects and tasks\n- Create, update, and delete tasks\n- Cross-platform support (macOS, Windows, Linux)\n- Secure token-based authentication\n- Automatic database discovery\n\n## Installation\n\n### Prerequisites\n\n- Node.js 18 or higher\n- Tackle desktop app installed and run at least once\n- Claude Code CLI\n\n### Quick Setup\n\n1. **Generate Auth Token in Tackle App**\n   - Open Tackle app\n   - Go to Settings (gear icon) → MCP Server\n   - Click \"Generate Token\" and copy it\n\n2. **Add to Claude Code**\n   ```bash\n   claude mcp add tackle \\\n     -s user \\\n     -e TACKLE_AUTH_TOKEN=your_token_here \\\n     -- npx tackle-mcp@latest\n   ```\n\n3. **Test Connection**\n   ```bash\n   claude \"list my tackle tasks\"\n   ```\n\n## Database Locations\n\nThe MCP server automatically discovers your Tackle database:\n\n- **macOS**: `~/Library/Application Support/Tackle/tackle.db`\n- **Windows**: `%APPDATA%\\Tackle\\tackle.db`\n- **Linux**: `~/.config/tackle/tackle.db`\n\nYou can override this with the `TACKLE_DB_PATH` environment variable:\n\n```bash\nclaude mcp add tackle \\\n  -s user \\\n  -e TACKLE_AUTH_TOKEN=your_token \\\n  -e TACKLE_DB_PATH=/custom/path/database.db \\\n  -- npx tackle-mcp@latest\n```\n\n## Available Commands\n\nOnce configured, you can use natural language with Claude Code or Gemini CLI:\n\n- \"List all my projects\"\n- \"Show tasks in [project name]\"\n- \"Create a task called 'Review PR' in the Development project\"\n- \"Mark task X as completed\"\n- \"Update the description of task Y\"\n\n## MCP Tools\n\nThe server exposes these tools to Claude Code or Gemini CLI:\n\n### list_projects\nList all projects in Tackle.\n\n```javascript\n{\n  includeArchived: boolean // Include archived projects (default: false)\n}\n```\n\n### list_tasks\nList tasks with optional filtering.\n\n```javascript\n{\n  projectId: string,  // Filter by project ID (optional)\n  status: string      // \"pending\", \"in_progress\", \"completed\", \"all\"\n}\n```\n\n### create_task\nCreate a new task.\n\n```javascript\n{\n  title: string,       // Required\n  projectId: string,   // Optional\n  description: string, // Optional\n  dueDate: string     // ISO date format (optional)\n}\n```\n\n### update_task\nUpdate an existing task.\n\n```javascript\n{\n  taskId: string,      // Required\n  title: string,       // Optional\n  status: string,      // Optional: \"pending\", \"in_progress\", \"completed\"\n  description: string  // Optional\n}\n```\n\n### delete_task\nDelete a task.\n\n```javascript\n{\n  taskId: string      // Required\n}\n```\n\n## Troubleshooting\n\n### \"Database not found\" error\n- Ensure Tackle app is installed and has been run at least once\n- Check the database exists at the expected location\n- Use `TACKLE_DB_PATH` to specify custom location\n\n### \"Invalid auth token\" error\n- Generate a new token in Tackle Settings → MCP Server\n- Ensure you copied the entire token\n- Check for extra spaces or quotes in your token\n\n### \"MCP authentication not configured\" error\n- Enable MCP Server in Tackle Settings\n- The app needs to create the auth tokens table first\n\n## Security\n\n- Auth tokens are hashed with SHA-256 before storage\n- Tokens are never logged or exposed\n- Each token can be revoked from Tackle Settings\n- Database access is limited to Tackle data only\n\n## Development\n\nTo run locally for development:\n\n```bash\ngit clone https://github.com/ActionGround/tackle-mcp\ncd tackle-mcp\nnpm install\nnpm start\n```\n\n## License\n\nMIT","readmeFilename":"README.md","_rev":"1-3c0c3f4d53f0032252ccd905962fdecb"}