Timesheet

Provides natural language access to the Timesheet API via standardized tools.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "timesheetio-timesheet-mcp": {
      "command": "npx",
      "args": [
        "@timesheet/mcp-server"
      ],
      "env": {
        "TIMESHEET_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

You can interact with the Timesheet API using an MCP server that translates natural language into actionable timer, task, and project commands. This server enables you to manage time tracking and project data through simple, conversational prompts, improving efficiency and consistency across your workflow.

How to use

To start using the Timesheet MCP server, you can choose how you want to run it based on your setup: use npx for a quick start, install globally for frequent use, or install locally in your project for a contained setup.

How to install

Prerequisites: ensure you have Node.js installed on your machine. You may also use npm or npx as described below.

# Quick start with npx (no installation required)
npx @timesheet/mcp

# Global installation for frequent use
npm install -g @timesheet/mcp

# Run the MCP server globally
timesheet-mcp

# Local installation for project-specific use
npm install @timesheet/mcp

# Start the MCP server from your local install
npx @timesheet/mcp-server

Additional content

Configuration and usage details help you connect your client and secure the server. You can provide your API token via environment variables or your client configuration. See the configuration section for concrete steps and example configurations.

Available tools

timer_start

Start a timer for a project or task using natural language input.

timer_stop

Stop the running timer and finalize the time entry.

timer_pause

Pause the timer to indicate a break or pause period.

timer_resume

Resume the timer after a break or pause.

timer_status

Check the current status of the running timer.

timer_update

Update details of the running timer, such as project or description.

task_add_note

Add a note to the current task.

task_add_expense

Record an expense against the current task.

task_add_pause

Add a manual pause to the current task timeline.

project_list

List all projects.

project_create

Create a new project.

project_update

Update an existing project.

project_delete

Delete a project.

task_list

List tasks with optional filters.

task_create

Create a new task with details.

task_update

Update an existing task.

task_delete

Delete a task.

auth_configure

Configure API authentication for the MCP server.