{
  "markdown": "# Timesheet MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@timesheet/mcp.svg)](https://www.npmjs.com/package/@timesheet/mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js Version](https://img.shields.io/node/v/@timesheet/mcp.svg)](https://nodejs.org)\n[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)\n\nA Model Context Protocol (MCP) server that provides natural language access to the Timesheet API through standardized tools.\n\n## Features\n\n- **Timer Management**: Start, stop, pause, and resume timers with natural language\n- **Task Enhancement**: Add notes, expenses, and pauses to running tasks\n- **Project Management**: Create, update, list, and delete projects\n- **Task Management**: Full CRUD operations for tasks\n- **Natural Language Support**: Use simple phrases to control your timer\n\n## Installation\n\n### Quick Start with npx\n\nThe easiest way to use the Timesheet MCP server is with npx (no installation required):\n\n```bash\nnpx @timesheet/mcp\n```\n\n### Global Installation\n\nFor frequent use, you can install globally:\n\n```bash\nnpm install -g @timesheet/mcp\ntimesheet-mcp\n```\n\n### Local Installation\n\nFor project-specific installation:\n\n```bash\nnpm install @timesheet/mcp\n```\n\n## Configuration\n\n### Using Environment Variables\n\nCreate a `.env` file with your API token:\n\n```env\nTIMESHEET_API_TOKEN=your-api-token-here\n```\n\n### Using Claude Desktop\n\nAdd to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"timesheet\": {\n      \"command\": \"npx\",\n      \"args\": [\"@timesheet/mcp\"],\n      \"env\": {\n        \"TIMESHEET_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\nFor a globally installed version:\n\n```json\n{\n  \"mcpServers\": {\n    \"timesheet\": {\n      \"command\": \"timesheet-mcp\",\n      \"env\": {\n        \"TIMESHEET_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n## Sample Prompts\n\n### Timer Control\n- **Start timer**: \n  - \"Start the timer for ProjectX\"\n  - \"Start timer for ProjectX 10 minutes ago\"\n  - \"Begin tracking time on the mobile app project\"\n  \n- **Stop timer**:\n  - \"Stop the timer\"\n  - \"Stop working\"\n  - \"I'm done for the day\"\n  \n- **Pause timer**:\n  - \"I have a break\"\n  - \"Pause the timer\"\n  - \"Taking lunch\"\n  \n- **Resume timer**:\n  - \"Resume work\"\n  - \"Back from break\"\n  - \"Continue timer\"\n  \n- **Check status**:\n  - \"What's my timer status?\"\n  - \"Am I tracking time?\"\n  - \"Show current timer\"\n\n### Task Enhancements\n- **Add notes**:\n  - \"Add a note: Fixed the login bug\"\n  - \"Note that I spoke with the client about requirements\"\n  \n- **Add expenses**:\n  - \"Add expense: $45 for lunch with client\"\n  - \"Record taxi expense of $25\"\n  \n- **Update task**:\n  - \"Update the description to 'Working on API integration'\"\n  - \"Mark current task as billable\"\n  - \"Add feeling rating of 4\"\n\n### Project Management\n- **List projects**:\n  - \"Show me all my projects\"\n  - \"List active projects\"\n  - \"What projects do I have?\"\n  \n- **Create project**:\n  - \"Create a new project called 'Website Redesign'\"\n  - \"Add project 'Mobile App v2' with default billable tasks\"\n  \n- **Update project**:\n  - \"Archive the old website project\"\n  - \"Rename project X to 'Client Portal'\"\n\n### Task Management\n- **List tasks**:\n  - \"Show today's tasks\"\n  - \"List all running tasks\"\n  - \"What did I work on yesterday?\"\n  \n- **Create task**:\n  - \"Create a 2-hour task for ProjectX from 9am to 11am\"\n  - \"Log 4 hours on the API project for yesterday\"\n  \n- **Update task**:\n  - \"Mark task X as paid\"\n  - \"Update task description\"\n  - \"Change task to non-billable\"\n\n## Available Tools\n\n### Timer Operations\n- `timer_start` - Start timer for a project\n- `timer_stop` - Stop the running timer\n- `timer_pause` - Pause the timer (start break)\n- `timer_resume` - Resume timer after break\n- `timer_status` - Check current timer status\n- `timer_update` - Update running timer details\n\n### Task Enhancements\n- `task_add_note` - Add note to current task\n- `task_add_expense` - Add expense to current task\n- `task_add_pause` - Add manual pause to current task\n\n### Project Management\n- `project_list` - List all projects\n- `project_create` - Create new project\n- `project_update` - Update existing project\n- `project_delete` - Delete project\n\n### Task Management\n- `task_list` - List tasks with filters\n- `task_create` - Create new task\n- `task_update` - Update existing task\n- `task_delete` - Delete task\n\n### Authentication\n- `auth_configure` - Set API authentication\n\n## Getting Your API Token\n\n1. Log in to your Timesheet account\n2. Go to Settings → API Access\n3. Generate a new API token\n4. Copy the token and add it to your configuration\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/timesheet/timesheet-mcp.git\ncd timesheet-mcp\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Run tests\nnpm test\n```\n\n## Troubleshooting\n\n### Timer not starting?\n- Ensure you have a valid API token configured\n- Check that the project ID exists in your account\n- Verify you have permission to create tasks for the project\n\n### Authentication errors?\n- Double-check your API token is correct\n- Ensure the token hasn't expired\n- Try generating a new token from your Timesheet settings\n\n## License\n\nMIT\n\n## Support\n\nFor issues and feature requests, visit: https://github.com/timesheet/timesheet-mcp/issues\n",
  "bytes": 5579,
  "sha": "ca9b93f8d5b8dc28c50f49c66a052fddf7ef425ce5ef621dcb57818a02087b79",
  "repo_slug": "timesheetio/timesheet-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_timesheetio_timesheet_mcp_c99207d0/readme"
}