Timing MCP Server

by tomoyanakano

332 downloads
Not rated
GitHub

About

Timing MCP Server is a Model Context Protocol server that enables AI assistants to interact with the Timing time‑tracking application. It provides tools to manage projects and time entries through the Timing API. This is an independent, third‑party project not affiliated with…

Details

Author
tomoyanakano
Downloads
332
Categories
Other

- List, create, update, and view project details
- Start, stop, list, create, and update time entries
- Simple JSON‑based configuration for Claude Desktop or Cursor
- Uses the official Timing API with an API key
- Independent open‑source project (MIT License)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Timing MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install Node.js and npm, clone the repository, run npm install and npm run build. Obtain a Timing API key from the Timing web integrations page. Configure the server by adding the provided JSON snippet to your Claude Desktop or Cursor configuration file, replacing the path and API key placeholders.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "timing mcp server": {
            "timing": {
                "command": "node",
                "args": [
                    "{{PATH}}/dist/index.js"
                ],
                "env": {
                    "TIMING_API_KEY": ""
                }
            }
        }
    }
}

McpServers

{
    "timing": {
        "command": "node",
        "args": [
            "{{PATH}}/dist/index.js"
        ],
        "env": {
            "TIMING_API_KEY": ""
        }
    }
}

Timing MCP Server

Model Context Protocol (MCP) server for Timing application features.
This server allows AI assistants to interact with Timing's features, enabling users to manage their time tracking and tasks more efficiently.

> [!warning]
> This repository is not affiliated with Timing. It is an independent project created to enhance the functionality of the Timing application.

Prerequisites

Before you begin, ensure you have the following installed:

- Node.js (version X.X.X or higher recommended)
- npm (usually comes with Node.js)
- Timing account (for API access)

Installation

1. Clone the repository:

    git clone https://github.com/your-username/timing-mcp-server.git
    cd timing-mcp-server
    

2. Install dependencies:

    npm install
    

3. Run build

    npm run build
    

Configuration

Copy the below json with the appropriate {{PATH}} values:

{
  "mcpServer": {
    "timing": {
      "command": "node",
      "args": ["{{PATH}}/dist/index.js"],
      "env": {
        "TIMING_API_KEY": "{{YOUR_TIMING_API_KEY}}"
      }
    }
  }
}

You can get your Timing API Key from here

For Claude, save this as claude_desktop_config.json in your Claude Desktop configuration directory

~/Library/Application Support/Claude/claude_desktop_config.json

For Cursor, save this as mcp.json in your Cursor configuration directory at:


~/.cursor/mcp.json

Available Tools

| Tool Name | Description |
|-----------|-------------|
| timing_list_projects | List projects in Timing |
| timing_project | Get project details |
| timing_create_project | Create a new project |
| timing_update_project | Update an existing project |
| timing_start_time_entry | Start a new time entry |
| timing_stop_time_entry | Stop the current time entry |
| timing_list_time_entries | List time entries |
| timing_create_time_entry | Create a new time entry |
| timing_time_entry | Get time entry details |
| timing_update_time_entry | Update an existing time entry |

Contributing

Contributions are welcome! If you'd like to contribute, please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/your-feature-name).
3. Make your changes.
4. Commit your changes (git commit -m 'Add some feature').
5. Push to the branch (git push origin feature/your-feature-name).
6. Open a Pull Request.

Please make sure to update tests as appropriate.

License

This project is licensed under the MIT License.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.