How to Use the Toggl Plan MCP in Claude

Q: How do I check existing milestones using Toggl Plan and Claude Desktop?

You run listmilestones. This command retrieves all milestone markers currently set up on your team's timeline. It’s a quick way to get an overview of major project checkpoints.

Q: Can I list all available projects using Toggl Plan and Claude Desktop?

Yep. The listworkspaceprojects tool shows every project currently registered in the workspace. This helps you scope out which timelines need attention.

Q: Is deleting a task permanent when using Toggl Plan and Claude Desktop?

Yes, be careful with deletetimelinetask. The server explicitly states this action is irreversible. Make sure you double-check before running it.

Manage project timelines and workloads directly within the Claude Desktop app.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Toggl Plan MCP to Claude Desktop

Create your Vinkius account to connect Toggl Plan to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Toggl Plan with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Project Roadmaps with Claude Desktop

Need to set up a new phase? Use `create_milestone` to drop a diamond marker right on the project timeline. You can also define specific work segments using `create_timeline_task`, specifying both a name and concrete start/end dates (YYYY-MM-DD). Your AI agent manages this all via the MCP Server, letting you build out complex roadmaps without leaving your local environment.

Check Team Status with Claude Desktop

Before planning anything, check who’s on the team. The `list_workspace_members` tool fetches every user in the workspace, while `list_workspace_projects` shows all current initiatives. This gives you immediate context for any timeline adjustments. It's also useful to see what tags are active across projects by calling `list_workspace_tags`. You get a full picture of who’s working on what.

Sync Project Changes with Claude Desktop

Don't worry about manually updating dates. The `update_timeline_task` tool lets you modify existing tasks by passing in a JSON object payload. This keeps your project plan accurate when scope changes mid-sprint. If a task is done, remember that `delete_timeline_task` permanently removes it. Use this caution; the action is irreversible.

Setup guide

Set up Toggl Plan MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Toggl Plan MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Toggl Plan MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under toggl-plan-1-mcp.

json

{
  "mcpServers": {
    "toggl-plan-1-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Toggl Plan. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Toggl Plan now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Toggl Plan MCP in Claude Desktop

You run `list_milestones`. This command retrieves all milestone markers currently set up on your team's timeline. It’s a quick way to get an overview of major project checkpoints.

The server uses standard YYYY-MM-DD format for all date inputs, whether you are creating a task or viewing a view. You can pass these ranges to `get_timeline_view` to narrow down your focus.

Yep. The `list_workspace_projects` tool shows every project currently registered in the workspace. This helps you scope out which timelines need attention.

Yes, be careful with `delete_timeline_task`. The server explicitly states this action is irreversible. Make sure you double-check before running it.

It manages core organizational data, including team member details (`list_workspace_members`), project names, milestone markers, and specific time ranges (dates).

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript