Toggl Plan MCP Server for Google ADK 10 tools — connect in under 2 minutes
Google Agent Development Kit (ADK) is Google's framework for building production AI agents. Add Toggl Plan as an MCP tool provider through the Vinkius and your ADK agents can call every tool with full schema introspection.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import (
StreamableHTTPConnectionParams,
)
# Your Vinkius token — get it at cloud.vinkius.com
mcp_tools = McpToolset(
connection_params=StreamableHTTPConnectionParams(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
)
)
agent = Agent(
model="gemini-2.5-pro",
name="toggl_plan_agent",
instruction=(
"You help users interact with Toggl Plan "
"using 10 available tools."
),
tools=[mcp_tools],
)
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Toggl Plan MCP Server
Connect your Toggl Plan workspaces to an AI agent entirely bypassing the complex graphical interfaces. Allow your project managers and team leads to directly read, create, and organize workload data, milestones, and daily tasks inside a conversational or command-driven environment.
Google ADK natively supports Toggl Plan as an MCP tool provider — declare the Vinkius Edge URL and the framework handles discovery, validation, and execution automatically. Combine 10 tools with Gemini's long-context reasoning for complex multi-tool workflows, with production-ready session management and evaluation built in.
What you can do
- Timeline Oversight — Search workspaces to list, read, or inspect the metadata details of specific timeline tasks and milestones
- Project Construction — Easily list all the active project segments directly on your terminal to know what your team is facing today
- Task Execution — Complete the full cycle of task management: Create new nodes on the timeline, update existing entries, or delete deprecated ones through simple instructions
- Fleet Operations — Manage human resources by securely listing all registered workspace users to assign workloads correctly
- Taxonomy Organization — Check and retrieve current tagging structures to ensure standardized labels
The Toggl Plan MCP Server exposes 10 tools through the Vinkius. Connect it to Google ADK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect Toggl Plan to Google ADK via MCP
Follow these steps to integrate the Toggl Plan MCP Server with Google ADK.
Install Google ADK
Run pip install google-adk
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Create the agent
Save the code above and integrate into your ADK workflow
Explore tools
The agent will discover 10 tools from Toggl Plan via MCP
Why Use Google ADK with the Toggl Plan MCP Server
Google ADK provides unique advantages when paired with Toggl Plan through the Model Context Protocol.
Google ADK natively supports MCP tool servers — declare a tool provider and the framework handles discovery, validation, and execution
Built on Gemini models, ADK provides long-context reasoning ideal for complex multi-tool workflows with Toggl Plan
Production-ready features like session management, evaluation, and deployment come built-in — not bolted on
Seamless integration with Google Cloud services means you can combine Toggl Plan tools with BigQuery, Vertex AI, and Cloud Functions
Toggl Plan + Google ADK Use Cases
Practical scenarios where Google ADK combined with the Toggl Plan MCP Server delivers measurable value.
Enterprise data agents: ADK agents query Toggl Plan and cross-reference results with internal databases for comprehensive analysis
Multi-modal workflows: combine Toggl Plan tool responses with Gemini's vision and language capabilities in a single agent
Automated compliance checks: schedule ADK agents to query Toggl Plan regularly and flag policy violations or configuration drift
Internal tool platforms: build self-service agent platforms where teams connect their own MCP servers including Toggl Plan
Toggl Plan MCP Tools for Google ADK (10)
These 10 tools become available when you connect Toggl Plan to Google ADK via MCP:
create_timeline_task
Requires workspace ID, task name, and project ID. Creates a new task on the Toggl Plan timeline
delete_timeline_task
This action is irreversible. Permanently deletes a task from the timeline
get_project_details
Retrieves details for a specific project
get_task_details
Retrieves details for a specific timeline task
list_milestones
Lists all project milestones
list_timeline_tasks
Requires a workspace ID. Lists all tasks on the Toggl Plan timeline for a specific workspace
list_workspace_projects
Lists all projects in a specific Toggl Plan workspace
list_workspace_tags
Lists all tags used for task categorization
list_workspace_users
Lists all users with access to the workspace
update_timeline_task
Provide updates as a JSON object. Updates an existing timeline task
Example Prompts for Toggl Plan in Google ADK
Ready-to-use prompts you can give your Google ADK agent to start working with Toggl Plan immediately.
"List all active projects in Workspace 992211."
"Create a timeline task named 'Re-authenticate module' in Project 19332, workspace 992211."
Troubleshooting Toggl Plan MCP Server with Google ADK
Common issues when connecting Toggl Plan to Google ADK through the Vinkius, and how to resolve them.
McpToolset not found
pip install --upgrade google-adkToggl Plan + Google ADK FAQ
Common questions about integrating Toggl Plan MCP Server with Google ADK.
How does Google ADK connect to MCP servers?
Can ADK agents use multiple MCP servers?
Which Gemini models work best with MCP tools?
Connect Toggl Plan with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Toggl Plan to Google ADK
Get your token, paste the configuration, and start using 10 tools in under 2 minutes. No API key management needed.