TrackingTime MCP Server for Mastra AIGive Mastra AI instant access to 12 tools to Add Time Entry, Create Project, Create Task, and more
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect TrackingTime through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this App Connector for Mastra AI
The TrackingTime app connector for Mastra AI is a standout in the Productivity category — giving your AI agent 12 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"trackingtime": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "TrackingTime Agent",
instructions:
"You help users interact with TrackingTime " +
"using 12 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with TrackingTime?"
);
console.log(result.text);
}
main();
* 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 TrackingTime MCP Server
Connect your TrackingTime account to any AI agent and simplify how you manage your productivity, project tasks, and billable hours through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and TrackingTime tool infrastructure. Connect 12 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Live Tracking — Start and stop timers for specific tasks instantly via AI commands to track your real-time activity.
- Task Management — Create, list, and update tasks, and organize them into specific projects for better workflow.
- Time Logging — Retrieve detailed logs of your time entries for any date range and manually add missing blocks of time.
- Project & Client Oversight — List all projects and customers to manage your business directory and assignments.
- Team Coordination — Query workspace users to understand team structure and member availability.
- Account Visibility — Fetch your user profile and verify account configurations directly from the agent.
The TrackingTime MCP Server exposes 12 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 12 TrackingTime tools available for Mastra AI
When Mastra AI connects to TrackingTime through Vinkius, your AI agent gets direct access to every tool listed below — spanning time-tracking, timesheets, billable-hours, and more. Every call is secured with network, filesystem, subprocess, and code evaluation entitlements inside a sandboxed runtime. Beyond a simple connection, you get a full AI Gateway with real-time visibility into agent activity, enterprise governance, and optimized token usage.
Manual time entry
Add new project
Add new task
Get current user
List project clients
List your projects
List your tasks
Get time logs
List team members
Start tracking time
Stop tracking time
Modify task
Connect TrackingTime to Mastra AI via MCP
Follow these steps to wire TrackingTime into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind the Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the TrackingTime MCP Server
Mastra AI provides unique advantages when paired with TrackingTime through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add TrackingTime without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every TrackingTime tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
TrackingTime + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the TrackingTime MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query TrackingTime, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed TrackingTime as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query TrackingTime on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using TrackingTime tools alongside other MCP servers
Example Prompts for TrackingTime in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with TrackingTime immediately.
"Start my timer for the 'Design Review' task."
"Show me all active tasks in the 'Marketing' project."
"What are my time logs for today?"
Troubleshooting TrackingTime MCP Server with Mastra AI
Common issues when connecting TrackingTime to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpTrackingTime + Mastra AI FAQ
Common questions about integrating TrackingTime MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.