Toggl MCP Server

🚀 MCP Toggl Server: A Beginner's Guide

This guide provides a comprehensive introduction to using the MCP Toggl Server, including installation, development tool integration, testing, and more.

🚀 Quick Start

Prerequisites

• Python version 3.11 or higher.
• A Toggl Track account.
• uv installed for dependency management.

Environment Variable Configuration

Create a .env file in the mcp_toggl_server folder:

EMAIL=your_toggl_email
PASSWORD=your_toggl_password

Installation Steps

1. Install uv:
   • For MacOS/Linux systems, run the following command:

     curl -LsSf https://astral.sh/uv/install.sh | sh
     

   • For Windows systems, run the following command:

     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
     

2. Restart the terminal to ensure the uv command takes effect.
3. Clone the code repository and set up the project:

   git clone [repository-url]
   cd mcp_toggl_server
   uv venv
   uv pip install --all
   

🛠️ Development Tool Integration

VS Code + GitHub Copilot Setup

1. Configure the MCP server: Add the following content to the .vscode/mcp.json file:

   "servers": {
     "toggl": {
       "type": "stdio",
       "command": "uv",
       "args": [
         "--directory",
         "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp_toggl_server",
         "run",
         "toggl_mcp_server.py"
       ],
       "envFile": "${workspaceFolder}/mcp_toggl_server/.env"
     }
   }
   

2. Update the configuration:
   • Replace /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp_toggl_server with the actual path.
   • If necessary, specify the full path of the uv executable in the command field. You can obtain the path by running which uv (Mac/Linux) or where uv (Windows).
3. Enable the server:
   • Hover over the MCP server configuration and click the start button to let Copilot discover available tools.
   • Switch to Agent mode to use Copilot.

Other MCP Client Integrations

1. For Claude Desktop, refer to the MCP Quick Start Guide.
2. For other MCP clients, refer to their corresponding documentation for configuration. Usually, you need to specify the server path and environment variables.

🧪 Testing and Development

Run the following command to test:

EMAIL=your_toggl_email PASSWORD=your_toggl_password mcp dev toggl_mcp_server.py

📄 License

(The specific license agreement content should be filled in here)

📚 Documentation

Overview of Toggl MCP Server Features

• Supports integration with Toggl Track.
• Provides detailed installation and configuration guidance.
• Supports integration with development tools through VS Code and GitHub Copilot.

Frequently Asked Questions

1. How to get a Toggl account?
   • Visit the Toggl official website to register and log in.
2. What should I do if an error occurs when installing uv?
   • Ensure a normal network connection or try changing the mirror source.
3. What should I pay attention to when configuring the .env file?
   • Ensure the file path is correct and the variable names are consistent with the documentation.

Contact Information

• If you have any questions or feedback, please contact: support@yourdomain.com

Additional Resources

1. Toggl Official Website
2. uv Tool Documentation
3. GitHub Copilot Documentation