{"_id":"@claydiffrient/repo-tasks-mcp-server","_rev":"3-19da1c3db5637a53f52d3db623cbfbe9","name":"@claydiffrient/repo-tasks-mcp-server","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@claydiffrient/repo-tasks-mcp-server","version":"0.1.0","keywords":["mcp","task-management","repo-tasks","llm","ai"],"author":{"name":"Clay Diffrient"},"license":"MIT OR Apache-2.0","_id":"@claydiffrient/repo-tasks-mcp-server@0.1.0","maintainers":[{"name":"claydiffrient","email":"clay.diffrient@gmail.com"}],"homepage":"https://github.com/claydiffrient/repo-tasks/tree/main/mcp-server","bugs":{"url":"https://github.com/claydiffrient/repo-tasks/issues"},"bin":{"repo-tasks-mcp":"dist/index.js"},"dist":{"shasum":"17fb96231a38cd3ba1c9a6f8262765793cc28a38","tarball":"https://registry.npmjs.org/@claydiffrient/repo-tasks-mcp-server/-/repo-tasks-mcp-server-0.1.0.tgz","fileCount":12,"integrity":"sha512-NVi/NGACbslDoIIDBR2HmxCjV3Cv4VPYp7TzZ5nXOTqnaaBY+5p8whidbCnyTGZ1YZW3mwPhwhF3QKBqpjz86g==","signatures":[{"sig":"MEYCIQDWAiZQbVtKWedUCvMHByBGgYtV20aTJnaav7XK/yL5FQIhAL7WoaALHFIuQSDnDEtuDJSqOM9dx2xXEMwzbK0tqwSq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41124},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"fa5a5d927d8f208d8b3e98c188952388f4e11207","scripts":{"build":"tsc","watch":"tsc --watch","prepare":"npm run build","postinstall":"node dist/check-binary.js || true"},"_npmUser":{"name":"claydiffrient","email":"clay.diffrient@gmail.com"},"repository":{"url":"git+https://github.com/claydiffrient/repo-tasks.git","type":"git","directory":"mcp-server"},"_npmVersion":"10.7.0","description":"MCP server for repo-tasks task management","directories":{},"_nodeVersion":"20.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/repo-tasks-mcp-server_0.1.0_1768160446744_0.06221328013633354","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@claydiffrient/repo-tasks-mcp-server","version":"0.1.1","keywords":["mcp","task-management","repo-tasks","llm","ai"],"author":{"name":"Clay Diffrient"},"license":"MIT OR Apache-2.0","_id":"@claydiffrient/repo-tasks-mcp-server@0.1.1","maintainers":[{"name":"claydiffrient","email":"clay.diffrient@gmail.com"}],"homepage":"https://github.com/claydiffrient/repo-tasks/tree/main/mcp-server","bugs":{"url":"https://github.com/claydiffrient/repo-tasks/issues"},"bin":{"repo-tasks-mcp":"dist/index.js"},"dist":{"shasum":"f4e64c5d182399d020d7d82765125ca3060479af","tarball":"https://registry.npmjs.org/@claydiffrient/repo-tasks-mcp-server/-/repo-tasks-mcp-server-0.1.1.tgz","fileCount":12,"integrity":"sha512-os9/7+fWisf2Ry82Ly5N3dluefPROe+/dkDfdCQbH0Vw/dgM1cPVNQCREaLYQS44GcH7MonVAiGtaYBiCD4SIw==","signatures":[{"sig":"MEUCIQDIL7AgqNQhj4Ek7s3YmU2Et3Ty2/Sp2U39Yr4krzUj9QIgJmDFbt5NmVcTNhdUrNbBXG/UFisyVSLZGN2gMP9LGA0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41244},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"00505ef923a75d3743232875b6308ed41785d1f0","scripts":{"build":"tsc","watch":"tsc --watch","prepare":"npm run build","postinstall":"node dist/check-binary.js || true"},"_npmUser":{"name":"claydiffrient","email":"clay.diffrient@gmail.com"},"repository":{"url":"git+https://github.com/claydiffrient/repo-tasks.git","type":"git","directory":"mcp-server"},"_npmVersion":"10.7.0","description":"MCP server for repo-tasks task management","directories":{},"_nodeVersion":"20.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/repo-tasks-mcp-server_0.1.1_1768161201412_0.7465391113630964","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@claydiffrient/repo-tasks-mcp-server","version":"0.1.2","description":"MCP server for repo-tasks task management","type":"module","main":"dist/index.js","bin":{"repo-tasks-mcp":"dist/index.js"},"scripts":{"build":"tsc","watch":"tsc --watch","prepare":"npm run build","postinstall":"node dist/check-binary.js || true"},"repository":{"type":"git","url":"git+https://github.com/claydiffrient/repo-tasks.git","directory":"mcp-server"},"homepage":"https://github.com/claydiffrient/repo-tasks/tree/main/mcp-server","bugs":{"url":"https://github.com/claydiffrient/repo-tasks/issues"},"keywords":["mcp","task-management","repo-tasks","llm","ai"],"author":{"name":"Clay Diffrient"},"license":"MIT OR Apache-2.0","engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.3.0"},"_id":"@claydiffrient/repo-tasks-mcp-server@0.1.2","gitHead":"3a006b8b335b0d91cddd53f12e59f9aab11d11f8","types":"./dist/index.d.ts","_nodeVersion":"20.14.0","_npmVersion":"10.7.0","dist":{"integrity":"sha512-cbqTTMthWN0MndXN+hiXdgUdcQ7sJnun/dy6aTV4BJhRWwNqKfj4TmVn7JEHEZs6L85K3keR4WJDnptPnpFDBA==","shasum":"d5b581bbd871371be89a7e3473e641fd7b36c454","tarball":"https://registry.npmjs.org/@claydiffrient/repo-tasks-mcp-server/-/repo-tasks-mcp-server-0.1.2.tgz","fileCount":12,"unpackedSize":41822,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAJaBryfo9JyAG4vDWhxGppQYbPXAOXYkojpYCfrWaJjAiEAnSkJQu7lR94EoDP6Kl36Uk0GegypGZ3+0/5sbbwpwXQ="}]},"_npmUser":{"name":"claydiffrient","email":"clay.diffrient@gmail.com"},"directories":{},"maintainers":[{"name":"claydiffrient","email":"clay.diffrient@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/repo-tasks-mcp-server_0.1.2_1768161790067_0.9885649683510278"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-11T19:40:46.582Z","modified":"2026-01-11T20:03:10.443Z","0.1.0":"2026-01-11T19:40:46.919Z","0.1.1":"2026-01-11T19:53:21.575Z","0.1.2":"2026-01-11T20:03:10.232Z"},"bugs":{"url":"https://github.com/claydiffrient/repo-tasks/issues"},"author":{"name":"Clay Diffrient"},"license":"MIT OR Apache-2.0","homepage":"https://github.com/claydiffrient/repo-tasks/tree/main/mcp-server","keywords":["mcp","task-management","repo-tasks","llm","ai"],"repository":{"type":"git","url":"git+https://github.com/claydiffrient/repo-tasks.git","directory":"mcp-server"},"description":"MCP server for repo-tasks task management","maintainers":[{"name":"claydiffrient","email":"clay.diffrient@gmail.com"}],"readme":"# repo-tasks MCP Server\n\nModel Context Protocol (MCP) server for [repo-tasks](../README.md) task management. This server allows LLMs like Claude to interact with your tasks through natural language.\n\n## Features\n\nThe MCP server exposes all repo-tasks functionality through MCP tools:\n\n### Task Management\n- **list_tasks** - List tasks by status, priority, or tag\n- **show_task** - Display detailed task information\n- **create_task** - Create new tasks with title, priority, tags, and notes\n- **update_task** - Update existing task properties\n- **move_task** - Move tasks between statuses\n- **start_task** - Begin work on a task (move to in-progress + create git branch)\n\n### Search & Discovery\n- **search_tasks** - Full-text search across all tasks with regex support\n\n### Version Control\n- **save_tasks** - Commit task changes to git\n\n### Editor Integration\n- **open_task** - Open task in default editor\n\n## Installation\n\n### From npm (Recommended)\n\nInstall the MCP server globally:\n\n```bash\nnpm install -g @claydiffrient/repo-tasks-mcp-server\n```\n\nThis will make the `repo-tasks-mcp` command available in your PATH.\n\n### Prerequisites\n\nThe MCP server requires the **repo-tasks CLI** to be installed. Install it using one of these methods:\n\n```bash\n# Homebrew (macOS/Linux)\nbrew install claydiffrient/tap/repo-tasks\n\n# Cargo (all platforms)\ncargo install repo-tasks\n\n# From source\ngit clone https://github.com/claydiffrient/repo-tasks.git\ncd repo-tasks\ncargo install --path .\n```\n\n**Note:** Node.js v18 or later is required for the MCP server.\n\n### From Source (Development)\n\nIf you want to build from source or contribute:\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/claydiffrient/repo-tasks.git\n   cd repo-tasks/mcp-server\n   ```\n\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n\n3. Build the TypeScript code:\n   ```bash\n   npm run build\n   ```\n\n4. Test the server:\n   ```bash\n   node dist/index.js\n   ```\n\n## Configuration\n\n### Claude Code\n\nAdd to your Claude Code MCP settings (`~/.config/claude-code/mcp_settings.json`):\n\n**If installed via npm:**\n\n```json\n{\n  \"mcpServers\": {\n    \"repo-tasks\": {\n      \"command\": \"repo-tasks-mcp\"\n    }\n  }\n}\n```\n\n**If running from source:**\n\n```json\n{\n  \"mcpServers\": {\n    \"repo-tasks\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/absolute/path/to/repo-tasks/mcp-server/dist/index.js\"\n      ]\n    }\n  }\n}\n```\n\nReplace `/absolute/path/to/repo-tasks` with the actual path to your repo-tasks repository.\n\nAfter adding the configuration, restart Claude Code or reload the MCP servers.\n\n### Claude Desktop\n\nThe server also works with Claude Desktop. Add to `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS:\n\n**If installed via npm:**\n\n```json\n{\n  \"mcpServers\": {\n    \"repo-tasks\": {\n      \"command\": \"repo-tasks-mcp\"\n    }\n  }\n}\n```\n\n**If running from source:**\n\n```json\n{\n  \"mcpServers\": {\n    \"repo-tasks\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/absolute/path/to/repo-tasks/mcp-server/dist/index.js\"\n      ]\n    }\n  }\n}\n```\n\n### Other MCP Clients\n\nThe server uses stdio transport and follows the standard MCP protocol. Configure your MCP client to run:\n\n**If installed via npm:**\n\n```bash\nrepo-tasks-mcp\n```\n\n**If running from source:**\n\n```bash\nnode /path/to/mcp-server/dist/index.js\n```\n\n## Usage Examples\n\nOnce configured, you can interact with repo-tasks through natural language in Claude Code:\n\n### Creating Tasks\n```\nCreate a new high priority task titled \"Add user authentication\" with tags \"security,backend\"\n```\n\n### Listing and Searching\n```\nShow me all tasks in the todo status\n\nSearch for tasks related to \"authentication\"\n\nList all high priority tasks\n```\n\n### Working on Tasks\n```\nStart working on task 20260110184347\n\nMove task create-start-command to testing\n\nShow details for task 20260110201217\n```\n\n### Version Control\n```\nSave all task changes with message \"Update sprint tasks\"\n```\n\n## Tool Reference\n\n### list_tasks\n\nList tasks with optional filters.\n\n**Parameters:**\n- `status` (string, optional): Filter by status (todo, in-progress, testing, done). Default: \"todo\"\n- `priority` (string, optional): Filter by priority (Low, Medium, High, Critical)\n- `tag` (string, optional): Filter by tag\n\n**Example:**\n```typescript\n{\n  \"status\": \"in-progress\",\n  \"priority\": \"High\"\n}\n```\n\n### show_task\n\nShow detailed information about a specific task.\n\n**Parameters:**\n- `task_id` (string, required): Task ID or slug\n\n**Example:**\n```typescript\n{\n  \"task_id\": \"20260110184347\"\n}\n```\n\n### create_task\n\nCreate a new task.\n\n**Parameters:**\n- `title` (string, required): Task title\n- `priority` (string, optional): Priority level. Default: \"Medium\"\n- `tags` (string, optional): Comma-separated tags\n- `notes` (string, optional): Task description/notes\n\n**Example:**\n```typescript\n{\n  \"title\": \"Implement user authentication\",\n  \"priority\": \"High\",\n  \"tags\": \"security,backend\",\n  \"notes\": \"Add JWT-based authentication system\"\n}\n```\n\n### update_task\n\nUpdate task properties (interactive).\n\n**Parameters:**\n- `task_id` (string, required): Task ID or slug\n\n### move_task\n\nMove a task to a different status.\n\n**Parameters:**\n- `task_id` (string, required): Task ID or slug\n- `new_status` (string, required): New status (todo, in-progress, testing, done)\n\n**Example:**\n```typescript\n{\n  \"task_id\": \"20260110184347\",\n  \"new_status\": \"testing\"\n}\n```\n\n### start_task\n\nStart working on a task (recommended for beginning work).\n\nMoves the task to in-progress and creates a git branch with format `{id}-{slug}`.\n\n**Parameters:**\n- `task_id` (string, required): Task ID or slug\n\n**Example:**\n```typescript\n{\n  \"task_id\": \"20260110184347\"\n}\n```\n\n### search_tasks\n\nSearch tasks by content.\n\n**Parameters:**\n- `query` (string, required): Search query (regex supported)\n\n**Example:**\n```typescript\n{\n  \"query\": \"authentication\"\n}\n```\n\n### save_tasks\n\nCommit task changes to git.\n\n**Parameters:**\n- `message` (string, optional): Commit message (auto-generated if not provided)\n\n**Example:**\n```typescript\n{\n  \"message\": \"Update sprint tasks\"\n}\n```\n\n### open_task\n\nOpen a task in the default editor.\n\n**Parameters:**\n- `task_id` (string, required): Task ID or slug\n\n## Development\n\n### Watch Mode\n\nRun TypeScript compiler in watch mode:\n\n```bash\nnpm run watch\n```\n\n### Testing\n\nTest the server manually using the MCP inspector:\n\n```bash\nnpx @modelcontextprotocol/inspector node dist/index.js\n```\n\n## Troubleshooting\n\n### \"repo-tasks binary not found\"\n\nThe server looks for the repo-tasks binary in:\n1. System PATH\n2. `./target/release/repo-tasks` (local release build)\n3. `./target/debug/repo-tasks` (local debug build)\n\nEnsure repo-tasks is installed or built from source.\n\n### Changes not reflected\n\nAfter modifying the TypeScript code, rebuild:\n\n```bash\nnpm run build\n```\n\nThen restart Claude Code to reload the MCP server.\n\n### Server not showing in Claude\n\n1. Check the configuration file path (`~/.config/claude-code/mcp_settings.json`)\n2. Verify the absolute path to `dist/index.js` is correct\n3. Check Claude Code logs for errors\n4. Restart Claude Code after configuration changes\n\n## License\n\nSame as repo-tasks: MIT OR Apache-2.0\n","readmeFilename":"README.md"}