# Toggl Plan MCP for AI Agents AI Agent Connect > Toggl Plan MCP lets you manage project timelines, milestones, and team workloads through your AI agent. It allows you to create tasks, update project status, and organize workspace data without having to navigate the web UI. It is built for anyone who needs to keep their project schedule accurate without the constant tab-switching. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_wsibxnInC3Ez3ZzIhtmHmzY6LSX7oWrsbHLveoWS/ai-agent-connect - **Tags:** timeline-planning, capacity-tracking, resource-management, milestones, workload-balancing, project-scheduling ## Description Connect your Toggl Plan workspaces to an AI agent to handle project logistics without navigating complex menus. This Connector lets you manage workload data, milestones, and daily tasks through a simple conversation. Instead of clicking through multiple screens to update a project, you can just tell your agent what needs to change. It handles the heavy lifting of finding the right workspace, creating new task nodes, and updating the timeline for you. You can query your entire workspace to see what is coming up next or pull a list of active projects to get a quick status update. It turns your project management from a manual data entry chore into a fluid conversation. Because Vinkius hosts this Connector, you can plug it into your existing workflow and let your agent handle the repetitive logistics of timeline management while you focus on actual work. ## Tools ### create_timeline_task This tool creates a new task on your Toggl Plan timeline. You just need to provide the workspace ID, task name, and project ID. ### delete_timeline_task This tool permanently removes a task from your timeline. Use it to clean up old entries or mistakes. ### get_project_details This tool fetches the specific details for a project. It is useful for quickly checking project-level information. ### list_milestones This tool shows a list of all project milestones. This helps you see the big picture of your project goals. ### list_workspace_projects This tool pulls a list of all projects in a specific workspace. It is the fastest way to see what is currently active. ### list_workspace_tags This tool lists all the tags used for categorizing your tasks. This helps you keep your naming conventions consistent. ### list_timeline_tasks This tool lists all tasks on the timeline for a specific workspace. Use this to get a full view of the current work queue. ### list_workspace_users This tool shows every user who has access to your workspace. This is perfect for checking permissions or finding team members. ### update_timeline_task This tool updates an existing task using a JSON object. Use this to change names, dates, or other details on the fly. ### get_task_details This tool retrieves all the information for a specific timeline task. Use this to see the full context of a work item. ## Prompt Examples **Prompt:** ``` What projects are we currently working on in Workspace 550? ``` **Response:** ``` I've pulled the active projects for Workspace 550: | Project Name | Project ID | | :--- | :--- | | **Q4 Infrastructure Overhaul** | 8821 | | **Client Portal Beta** | 9930 | | **Internal API Refactor** | 4412 | ``` **Prompt:** ``` Create a new task called 'Database Schema Review' in Project 102 for workspace 550. ``` **Response:** ``` Done! I've added the new task to your timeline. * **Task:** Database Schema Review * **Project ID:** 102 * **New Task ID:** 77210 * **Status:** Active ``` **Prompt:** ``` Can you show me the milestones for the 'Mobile App' project? ``` **Response:** ``` Here are the current milestones for the **Mobile App** project: * ✅ Phase 1: UI Wireframes * 🟡 Phase 2: Backend Integration * ⚪ Phase 3: QA & Bug Hunting * ⚪ Phase 4: App Store Submission ``` ## Capabilities ### Create timeline tasks Add new work items to your project timeline with a simple command. ### Update project status Modify existing tasks or project details to keep your schedule accurate. ### List workspace projects Get a complete overview of every project active in your workspace. ### Track milestones View all project milestones to track high-level progress. ### Manage workspace users See who has access to your workspace to manage team assignments. ### Organize task tags Retrieve your tagging structure to keep your project data standardized. ### Remove old tasks Delete outdated tasks from your timeline to keep your view clean. ## Use Cases ### Rapidly updating project status during standups A project manager asks their agent to update the API Migration task to Complete and create a new milestone for the next phase. The agent handles both actions instantly. ### Auditing team capacity across workspaces A resource planner asks the agent to list all projects and users in Workspace 101. The agent provides a quick summary of the current team load. ### Adding new tasks from a meeting During a meeting, a lead needs to add five new tasks to the roadmap. They tell the agent, which populates the timeline without any manual typing. ### Cleaning up old project data A user wants to remove a series of deprecated tasks from last year's project. They ask the agent to delete them, and it clears the clutter for them. ## Benefits - Stop clicking through menus to create tasks. You can add new work items to your timeline instantly from your chat interface. - Get a bird's eye view of your work. Quickly see what is happening across your entire portfolio with a single request. - Keep your data clean and consistent. Ensure your team is using the correct labels for every task by retrieving your tagging structure. - Simplify team management. Quickly identify who is on the team and who needs access without hunting through settings. - Update statuses in seconds. Keep your project moving without the friction of manual data entry by updating task details on the fly. - Retrieve specific details on demand. Pull deep information on projects or tasks exactly when you need it. ## How It Works The bottom line is you get a hands-free way to manage project timelines and team workloads. 1. Subscribe to the Toggl Plan MCP on the Vinkius platform. 2. Provide your Toggl Plan API token to authenticate your workspace. 3. Start asking your AI agent to create tasks, list projects, or update timelines. ## Frequently Asked Questions **Can I use the Toggl Plan MCP to manage my team's workload?** Yes, it allows you to list users and projects to see who is doing what. This helps you get a clear view of your team's capacity without manual auditing. **Does this Connector let me create new tasks on my timeline?** Yes, you can use your agent to add new task nodes to any project. It's a fast way to capture new action items during meetings. **Can I update existing project milestones?** Yes, the agent can modify project details and milestones for you. You can update status updates or change dates with a simple request. **Will this Connector help me keep my project tags organized?** Yes, it can retrieve your current tagging structures to ensure consistency. This helps keep your project data standardized across the workspace. **Is it possible to delete old tasks using this?** Yes, you can instruct your agent to permanently remove deprecated tasks. This helps keep your project timeline clean and relevant. **Can I see all the projects in a specific workspace at once?** Yes, you can ask the agent to list every project in a workspace by ID. It's the fastest way to get a high-level overview of your active work. **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.