How to Use the Toggl Plan MCP in Claude Code

Q: How do I check if Toggl Plan is ready for scripting with Claude Code?

You can run listworkspaceprojects to verify that all intended projects are visible and accessible. This confirms the basic connectivity between your script and the MCP Server.

Q: Can I use Claude Code to list tasks across multiple projects in Toggl Plan?

Yes. You run listtimelinetasks while supplying a workspace ID as an argument. This aggregates all current project tasks into a single output stream for your script.

Q: Does the Toggl Plan and Claude Code integration touch user data?

Yes, it accesses user records via listworkspaceusers. The server reads details about which users have access to the workspace, ensuring your scripts respect permissions.

Q: If I need to delete a task in Toggl Plan using Claude Code, is that action reversible?

No. When executing deletetimelinetask, the server confirms this action is irreversible. Your CI/CD pipeline must account for this by running necessary pre-checks.

Integrate Toggl Plan API calls into CI/CD pipelines using the Claude Code MCP Server.

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 Code

Create your Vinkius account to connect Toggl Plan to Claude Code 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 Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Scripting Task Creation and Modification

Write a script that needs to inject a task on the Toggl Plan timeline? Your agent runs `create_timeline_task` by feeding it the required workspace ID, task name, and project ID parameters into your shell script. If a phase changes, you can automate status updates using `update_timeline_task`. You simply pass the necessary JSON payload to modify existing tasks.

Bulk Reporting on Project Status

Need an audit report of all current work? The server exposes `list_timeline_tasks`, which requires a workspace ID. This lets your script pull every task for reporting or validation. Before running the report, you might want to check available classifications by calling `list_workspace_tags`.

Project Structure Validation

To validate a deployment scope, first run `list_workspace_projects`. This ensures your script knows all valid project IDs. You can pair this with `get_project_details` to fetch specific metadata required for the CI/CD step. The server also lets you list milestones via `list_milestones`, helping your pipeline validate the overall project roadmap.

Setup guide

Set up Toggl Plan MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see toggl-plan-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Toggl Plan transactions." It will automatically discover and invoke the available Toggl Plan tools.

Terminal

claude mcp add --transport http toggl-plan-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Toggl Plan MCP

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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "toggl-plan-mcp": {
      "type": "url",
      "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 Code

You can run `list_workspace_projects` to verify that all intended projects are visible and accessible. This confirms the basic connectivity between your script and the MCP Server.

It handles task metadata, project IDs, workspace IDs, milestone information, user access records, and tag names. Essentially, it touches all structured organizational data about your team's work.

Yes. You run `list_timeline_tasks` while supplying a workspace ID as an argument. This aggregates all current project tasks into a single output stream for your script.

Yes, it accesses user records via `list_workspace_users`. The server reads details about which users have access to the workspace, ensuring your scripts respect permissions.

No. When executing `delete_timeline_task`, the server confirms this action is irreversible. Your CI/CD pipeline must account for this by running necessary pre-checks.

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