Toggl Plan MCP. Manage workloads and tasks without clicking through the UI.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Toggl Plan lets your AI agent manage complex project timelines directly from a chat window. It handles creating tasks, listing milestones, updating resource workloads, and checking user roles—all without you needing to click through Toggl's graphical interface.
Your agent acts like an API wrapper for all core planning functions, letting PMs keep their workflow inside their conversation.
What your AI agents can do
Create timeline task
Adds a new task node onto the project timeline. Requires the workspace ID, task name, and project ID.
Delete timeline task
Permanently removes a task from the timeline. This action cannot be undone.
Get project details
Retrieves specific data points for a single, targeted project ID within Toggl Plan.
The agent retrieves a list of all defined project milestones for immediate visibility.
It lists every task within a specific workspace, giving you an overview of the current workload.
You can generate and add a new project task directly to the timeline using simple parameters.
The agent modifies an existing timeline entry by accepting data updates, keeping records current.
It pulls a directory of all registered users tied to the specific workspace ID for resource planning.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Toggl Plan MCP Server: 10 Tools for Scheduling & Planning
These tools let you manage every aspect of your Toggl Plan workspace—from listing users to updating task milestones—all through conversational commands.
019d7613create timeline task
Adds a new task node onto the project timeline. Requires the workspace ID, task name, and project ID.
019d7613delete timeline task
Permanently removes a task from the timeline. This action cannot be undone.
019d7613get project details
Retrieves specific data points for a single, targeted project ID within Toggl Plan.
019d7613get task details
Pulls all the metadata and status information for one specific timeline task.
019d7613list milestones
Retrieves a comprehensive list of every defined project milestone in the workspace.
019d7613list timeline tasks
Lists all tasks in a given workspace ID, providing an overview of everything currently scheduled.
019d7613list workspace projects
Retrieves a directory listing of every active project within the designated Toggl Plan workspace.
019d7613list workspace tags
Checks and lists all available tags used to categorize tasks in the workspace, ensuring consistency.
019d7613list workspace users
Provides a full list of every user account that has access to the workspace for resource tracking.
019d7613update timeline task
Modifies an existing timeline task's details. You must provide all updates as a JSON object.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Toggl Plan, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
This server gives your AI client direct access to Toggl Plan data. Forget clicking through the clunky web UI just to run a few queries or make some changes. Your agent acts like an API wrapper for all core planning functions, letting you manage complex project timelines right from your chat window.
Project Visibility & Status Checks
Your AI client can pull key structural data first. You can ask it to retrieve a directory listing of every active project within the designated workspace using list_workspace_projects. Want to know what big markers are set? It'll grab a complete list of defined project milestones via list_milestones. If you need specifics on one particular job, your agent runs get_project_details for that targeted Project ID.
For an overview of everything currently running in the space, it pulls all tasks using list_timeline_tasks. You can also check what tags are available to keep things consistent by calling list_workspace_tags, and if you need to track down the specifics on one node, get_task_details provides all the metadata and status info for that specific task.
Managing Tasks & Timelines
The agent handles the full lifecycle of a project task. Need a new step added? You use create_timeline_task, feeding it the required Workspace ID, Task Name, and Project ID to add a fresh node onto the timeline. If that task is obsolete or needs removing, you can permanently delete it using delete_timeline_task—just remember, that action cannot be undone.
To keep records current when details change, your agent modifies an existing entry with update_timeline_task; this requires you to feed all updates as a structured JSON object.
Team and Resource Management
Managing people is just as easy. For resource planning, it pulls a directory of every user account that has access to the workspace ID using list_workspace_users. When you need project specifics for one job, you can also fetch detailed information about that single Project ID with get_project_details.
Your agent handles everything from listing team users and checking available tags to building new tasks directly into the timeline. It keeps your workflow contained inside your conversation so you never have to leave your terminal.
How Toggl Plan MCP Works
- 1 First, subscribe your AI client to this component and provide it with your Toggl Plan API Token.
- 2 Next, instruct your agent using a plain language query. For example: 'List all active projects in workspace 992211.'
- 3 The agent executes the necessary tool calls, processes the data (e.g.,
list_workspace_projects), and returns structured results you can use immediately.
The bottom line is that your AI client acts as a direct command-line interface to Toggl Plan's core scheduling functions, bypassing the UI entirely.
Who Is Toggl Plan MCP For?
This is for Project Managers and Resource Planners who hate context switching. If you spend too much time jumping between your chat tool and a complex planning dashboard just to check due dates or assign work, this saves you clicks. It puts the whole project graph right into your conversation.
Uses list_timeline_tasks to get an instant status update on all tasks in a workspace without leaving Slack or Teams.
Runs list_workspace_users and compares those results against project milestones using the agent to ensure no team member is over-allocated.
Uses the agent to push technical updates or log hours directly into the timeline, bypassing the full Toggl web interface.
What Changes When You Connect
- Full Task Lifecycle Control: Instead of manually logging into Toggl to create or update a task, use
create_timeline_taskorupdate_timeline_task. Your agent handles the JSON object passing—you just talk to it. This keeps you in your chat environment. - Instant Project Visibility: Need to know what's running? Running
list_workspace_projectspulls all active project segments directly into your conversation, saving you from navigating multiple dashboards. - Resource Allocation Check: Stop guessing who has capacity. Use
list_workspace_usersand cross-reference user lists against milestones found vialist_milestones. You can assign work accurately every time. - Deep Metadata Dive: Don't just get a list—get details. Run
get_project_detailsorget_task_detailsto pull specific data points, like due dates or assigned owners, for critical follow-ups. - Data Standardization: Before you build anything, check the rules. Running
list_workspace_tagsensures your team uses standardized labels, so your reports don't get messy.
Real-World Use Cases
Onboarding a New Feature
The PM needs to know if the new 'API Gateway' project is ready. They ask their agent: 'What projects are active in Workspace 992211?'. The agent runs list_workspace_projects, instantly listing all candidates, allowing the PM to immediately run get_project_details on the correct ID without searching.
End-of-Week Workload Audit
A team lead needs a quick audit of who logged hours. They instruct the agent to list all users via list_workspace_users. Then, they use this user directory to check specific task workloads using list_timeline_tasks for capacity checks.
Quick Task Correction
A developer realizes a deadline is wrong. Instead of finding the old task and editing it, they send: 'Update task ID 52003 with new due date.' The agent uses update_timeline_task immediately, correcting the timeline without manual steps.
Checking Dependencies
The team is starting Phase 2. A PM asks: 'What milestones must be hit before we start?' The agent calls list_milestones, providing a definitive checklist of required deliverables and their status.
The Tradeoffs
Trying to guess IDs
A user tries to update a task by typing its name: 'Update the marketing task.' The agent fails because it needs the specific Task ID, not just the text.
→
Always start by listing what you need. Use list_timeline_tasks with the workspace ID first. Then grab the required Task ID and use update_timeline_task to make sure your changes hit the right record.
Over-relying on project names
A user asks, 'What are the details for the billing system?' The agent can't know if they mean Project 19332 or Project 19445 without explicit IDs.
→
Use list_workspace_projects first to confirm the correct project ID. Then, use that number with get_project_details for accurate data retrieval.
Assuming a task exists
A user attempts to update an old or deleted task without verifying its status. The API call fails because the node is gone.
→
Check first. Always run list_timeline_tasks on the workspace ID you care about. This confirms the task is active and gives you the most current metadata before attempting any updates.
When It Fits, When It Doesn't
Use this server if your workflow requires managing project scope, milestones, or team capacity using structured data inputs (IDs, JSON objects). The strength here is its focus on granular CRUD operations: you can list everything, get specific details, and then create/update/delete tasks. Don't use this if your primary need is simple messaging, document storage, or calendar booking—you'll need a dedicated communication tool for that. If all you need is to see the current user list without touching any task data, list_workspace_users is enough. But if you need to combine user lists with project capacity checks, this server does it best.
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually tracking who owns what and when it's due is a massive time sink.
Right now, checking progress means jumping into the Toggl web app. You open the workspace view to see tasks, then you click on a project segment to find milestones. If your coworker asks who owns a resource, you have to navigate through user directories and cross-reference everything manually. It's clicks, tabs, and copy-pasting.
With this MCP server, you just talk to your agent. You ask it to check the workload for 'Q4 Roadmap'. The agent runs `list_workspace_projects` then combines that with `list_milestones` in a single command. It gives you the answer—the data—right back in your chat.
Toggl Plan MCP Server: Control task creation and updates via conversation.
Previously, adding a simple follow-up task meant logging into the web UI. You had to find the right project, click 'Add Task', type the name, select the date range, and hit save. It’s three separate steps just for one item.
Now, you tell your agent: 'Create a timeline task named 'Final Review' in Project 19332.' The agent uses `create_timeline_task` instantly. Done. Zero clicks needed.
Common Questions About Toggl Plan MCP
How do I list all projects using the Toggl Plan MCP Server? +
Use the list_workspace_projects tool. This requires specifying the workspace ID. It returns a full directory of every active project name and its associated ID.
Can I update an old task using `update_timeline_task`? +
Yes, but you must provide the current Task ID for it to work. You'll need to run get_task_details first to grab that unique ID and verify its existence.
Does Toggl Plan MCP Server help me assign work? +
It helps you plan the assignment. Run list_workspace_users to see available people, then use task tools like create_timeline_task to attach the workload to a specific person.
What if I delete a task using `delete_timeline_task`? +
The deletion is permanent. The tool provides no undo function, so always confirm with your team before running this action.
How do I set up authentication for `list_timeline_tasks`? +
You provide your API Token and workspace ID during setup. The agent uses these credentials to authorize all read operations, ensuring the tasks listed belong to the correct workspace.
How does the `list_workspace_tags` tool help me maintain standardized labeling? +
It retrieves every current tagging structure used in your workspace. This lets you check existing labels before creating new ones, which prevents data inconsistencies and ensures uniform categorization.
What happens if I use `get_task_details` with an incorrect Task ID? +
The system returns a specific error message indicating the task was not found. This stops the agent from attempting to process invalid data, keeping your workflow accurate.
How do I use `list_milestones` to map out high-level project goals? +
It retrieves a list of all defined project milestones across your workspace. This gives you the top-tier checkpoints so your agent can schedule tasks against major, long-term deliverables.
Where do I obtain my Toggl Plan Access Token? +
Navigate to the Toggl Plan web panel, head over to your Profile settings, and locate the Developer/API Integrations segment. You will need a valid Access Token (often labeled API or OAuth Bearer token in your administrative view). Create it permanently and keep the exposed hash secure.
Does the system support permanent deletion of elements? +
Yes. This connector features a delete_timeline_task handler. If specifically instructed by you, the AI agent is capable of making a permanent removal request which cannot be un-done. You should instruct the AI cautiously when using mutations.
Are there any data sync delays when updating timelines with the agent? +
No. Toggl Plan's API ensures immediate reflection of all timeline and milestone changes. When the agent updates a task or resource allocation, it instantly appears in the web interface for all workspace users without any caching delays.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Linkwarden
Manage your bookmarks and web archives with Linkwarden — organize collections, preserve pages, and manage links directly from your AI agent.
Lyft
AI ride management: request rides, estimate costs, and track trips via agents.
Engineering Compliance Prover
Forces AI to validate structural designs against US codes (ASCE, ACI, NEC). Demands real capacity-demand ratios, traced load paths, specific material tolerances, and FMEA instead of vague appeals to 'industry standards'.
You might also like
Beisen (iTalentX)
Comprehensive HR cloud platform — manage employees, attendance, and recruitment via AI.
Rarible (Multi-chain NFT Protocol)
Access multi-chain NFT data — query items, collections, activities, and market statistics across Ethereum, Polygon, and more via Rarible.
New York Times
Access top stories, article search, best-seller lists, and movie reviews via the NYTimes API.