# timeghost MCP for AI Agents AI Agent Connect

> timeghost MCP connects your timeghost account to your AI client to manage your Microsoft 365 projects through simple conversation. Instead of jumping between tabs to check budgets or log hours, you can ask your agent for status updates, list tasks, or pull team productivity metrics directly. It turns your AI into a project coordinator that understands your real-world workload.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_PMwLn00ROEeKOiYUYjOQmmMf9y8t8naK7BmqDz0h/ai-agent-connect
- **Tags:** time-tracking, project-management, microsoft-365, timesheets, resource-planning, timeghost, mcp

## Description

This Connector connects your timeghost account to your AI client so you can manage your Microsoft 365 projects through simple conversation. Instead of hunting through different tabs to see if a budget is on track or who is assigned to a specific task, you can just ask your agent to pull that data for you. It turns your project management into a conversation. You can check project health metrics, pull detailed time logs, and see your full task pipeline without ever leaving your workspace. By adding this to your Vinkius catalog, you get a dedicated coordinator that handles the heavy lifting of data retrieval. You stop worrying about missing a deadline or a budget gap and start focusing on the actual work.

## Tools

### get_timeghost_task
Get the full details for a single task. Use this to see specific requirements or status for one item.

### get_timeghost_entry
Fetch a specific time log. This is useful for checking the duration and metadata of a single entry.

### list_timeghost_projects
View a full list of projects. This helps you keep track of every project you are currently managing.

### check_timeghost_status
Verify that your API connection is active. Use this to ensure your agent is synced before you start work.

### list_timeghost_entries
Retrieve time logs filtered by date or user. Use this to pull specific logs for auditing or reporting.

### list_timeghost_members
See everyone in your workspace. This helps your agent keep team context clear for every assignment.

### list_timeghost_workspaces
See all workspaces and organizational settings. This gives your agent context on your environment.

### get_timeghost_project
Pull specific details for a project. This includes budget status and high-fidelity health metadata.

### list_timeghost_tasks
Filter and list tasks by project ID. This helps you isolate specific pipelines for deep dives.

### list_timeghost_clients
See all clients associated with your account. This helps you get a bird's eye view of your client base.

## Prompt Examples

**Prompt:** 
```
What's the budget status for the App Dev project?
```

**Response:** 
```
I've checked the **App Dev** project for you. Here is the current health:

*   **Budget Status:** 80% used
*   **Health Metric:** On track
*   **Recent Activity:** 12 hours logged in the last 48 hours

Would you like me to list the specific tasks associated with this project?
```

**Prompt:** 
```
Show me the last 5 time logs for the API Design task.
```

**Response:** 
```
I've retrieved the recent logs for **API Design**. Here are the last 5 entries:

| Date | User | Duration |
| :--- | :--- | :--- |
| Oct 24 | Jane D. | 2h 15m |
| Oct 23 | John S. | 3h 00m |
| Oct 22 | Jane D. | 1h 45m |
| Oct 21 | Mike R. | 4h 10m |
| Oct 20 | John S. | 2h 30m |

Total time logged: **15 hours 40 minutes**.
```

**Prompt:** 
```
Who are the members in the Marketing workspace?
```

**Response:** 
```
The **Marketing** workspace currently has the following 6 members:

*   Sarah Jenkins (Lead)
*   David Chen
*   Elena Rodriguez
*   Marcus Thorne
*   Aisha Khan
*   Tom Baker

Would you like to see the specific tasks assigned to any of these members?
```

## Capabilities

### Pull project health metrics
Get real-time status on budgets and project metadata via your agent.

### Filter and list specific tasks
Isolate specific technical pipelines by filtering tasks by project ID.

### Retrieve detailed time logs
Pull specific time entries filtered by date range or user.

### Audit team member lists
See everyone in your workspace to maintain context for assignments.

### Verify API connectivity
Check your account status to ensure your connection is healthy.

### Scan workspace profiles
Access organizational settings to understand your environment.

## Use Cases

### Quick budget checks for PMs
A project manager asks their agent for the budget status of a specific project. The agent uses `get_timeghost_project` to report the percentage used and health metrics instantly.

### HR payroll auditing
An HR admin needs to verify hours for a specific user last week. They ask the agent to list entries for that user, and the agent pulls the data using `list_timeghost_entries`.

### Team capacity planning
A team lead wants to see who is on the project. They ask the agent to list members, and it uses `list_timeghost_members` to show everyone in the workspace.

### Task pipeline isolation
A developer needs to see only the tasks for a specific project. The agent uses `list_timeghost_tasks` to filter the list and show only the relevant items.

## Benefits

- Get instant project health metrics using `get_timeghost_project` to see where your budget stands.
- Filter your task list using `list_timeghost_tasks` to isolate specific technical pipelines.
- Pull specific time logs with `list_timeghost_entries` to check durations for any user.
- Keep your team context clear by using `list_timeghost_members` to see who is available.
- Verify your account is active and synced with `check_timeghost_status` before starting your day.
- Access full workspace profiles with `list_timeghost_workspaces` to understand your organizational settings.

## How It Works

The bottom line is that it turns your time tracking data into a conversational interface for your agent.

1. Subscribe to the Connector through the Vinkius catalog.
2. Grab your API Token from your timeghost settings.
3. Connect your AI client and start asking for project data.

## Frequently Asked Questions

**Can I use timeghost MCP to see my project budgets?**
Yes, you can ask your agent to pull real-time health metrics and budget statuses for any project in your account.

**Does timeghost MCP work with my Microsoft 365 logs?**
Yes, it syncs with your Microsoft 365 environment to provide a unified view of your time tracking and project data.

**How does timeghost MCP help with team management?**
It lets you quickly list members and see task assignments, making it easy to see who is working on what without manual searching.

**Can I use timeghost MCP to find specific tasks?**
Yes, you can ask your agent to filter and list tasks based on specific project IDs or other criteria.

**Is timeghost MCP good for HR audits?**
It's excellent for HR because it allows you to pull detailed time entries and workspace assignments for payroll verification.

**Can I see workspace settings with timeghost MCP?**
Yes, the Connector can retrieve workspace profiles and organizational settings to give your agent a full view of your environment.

**How do I find my timeghost API Token?**
Log in to your account, navigate to **Settings** > **API Keys**, and generate a new high-fidelity **API Token**.

**Can I check project budgets via AI?**
Yes! The `get_timeghost_project` tool allows your agent to retrieve high-fidelity budget metadata and financial health data for any specific project.

**How do I list my workspace members?**
Use the `list_timeghost_users` tool to retrieve the complete high-fidelity directory of members along with their unique identifiers for precise orchestration.