# Timeghost MCP > timeghost connects your AI agent directly to your Microsoft 365 time tracking data. It lets you pull working hours, project budgets, and team assignments from Teams and Outlook using natural conversation. You stop logging timesheets manually; your agent coordinates all the project details for you. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** time-tracking, project-management, microsoft-365, timesheets, resource-planning, timeghost, mcp ## Description You connect this server to your agent, and it handles all the messy project bookkeeping straight through chat. You don't gotta open Teams or Outlook and manually log anything anymore. Your AI client gets deep visibility into everything—from individual task logs up to full workspace budgets. ### Project Oversight and Status Checks Check the connection first: `check_timeghost_status` confirms your API key is talking to the system, so you know all your data calls are gonna work right. To see what projects you're working on, run `list_timeghost_projects`; this spits out a list of every project and tells you exactly how much budget utilization each one has used up. If you need the full technical rundown on just one project, use `get_timeghost_project` to pull all its metadata and current status metrics. ### Time Logging and Retrieval Need time data? You can run `list_timeghost_entries`, which pulls a list of entries letting you filter by a specific date range or even a team member's name. If you know the unique ID, use `get_timeghost_entry` to retrieve all the detailed logs for just one work session. To track down your assignments, run `list_timeghost_tasks`; you can narrow that search by linking it straight to a specific project ID. For deep context on a single task—like who's assigned or what parent project it belongs to—call `get_timeghost_task`. ### Directory and Context Tools Your agent tracks the whole organization, too. Run `list_timeghost_members` for a complete roster of everyone and every collaborator in your workspace. You can also check out who's paying attention by running `list_timeghost_clients`, which gives you all the client accounts connected to your directory. If you need an overview of what organizational settings are available, use `list_timeghost_workspaces` to show all associated workspaces and profile settings. ## Tools ### list_timeghost_clients Lists all client accounts connected to your timeghost directory. ### get_timeghost_project Fetches all technical metadata and current status metrics for one specific project. ### get_timeghost_task Gets detailed information about a single task, including its assignment and parent project. ### get_timeghost_entry Retrieves specific details for a single time log entry using its unique ID. ### list_timeghost_projects Generates a list of all projects, including their current budget utilization percentages. ### check_timeghost_status Verifies the connection status of your API key to ensure all data calls work correctly. ### list_timeghost_tasks Lists technical tasks, letting you narrow the search by linking them to a specific project ID. ### list_timeghost_entries Retrieves a list of time entries, allowing you to filter by date range or user name. ### list_timeghost_members Provides a roster of all people and collaborators within your organizational workspace. ### list_timeghost_workspaces Shows all available workspaces and organizational settings profiles in your account. ## Prompt Examples **Prompt:** ``` List all active projects in my timeghost account. ``` **Response:** ``` I've retrieved your projects. You currently have 8 active high-fidelity projects, including 'App Development' (Budget: 80% used) and 'Q2 Marketing'. Would you like the detailed health metadata for any of them? ``` **Prompt:** ``` Show the last 5 time entries for task 'API Design'. ``` **Response:** ``` Timesheet orchestrated! For the task 'API Design', I've identified 5 recent high-fidelity time entries, totaling 12 hours. I've retrieved the technical logs and duration for your review. Need help summarizing the productivity? ``` **Prompt:** ``` Check the connectivity status for the 'Marketing' workspace. ``` **Response:** ``` Workspace directory orchestrated! The 'Marketing' workspace is currently 'ACTIVE' and fully synchronized with Microsoft 365. Your API connection is healthy. Shall I retrieve the detailed resource utilization metadata for this workspace? ``` ## Capabilities ### Get Specific Time Entries Retrieves detailed logs for one specific work session or entry point. ### List All Projects and Budgets Pulls a list of every project, giving you its status and budget utilization at a glance. ### Access Team Directory Lists all team members and collaborators in your workspace for context alignment. ### Track Specific Tasks Retrieves details on tasks, optionally filtering them to a specific project ID or pipeline. ### Monitor Workspace Health Lists and checks the status of all associated workspaces and organizational settings. ## Use Cases ### Quarterly Budget Review The PM needs to know if the 'Q3 Marketing' project is over budget. Instead of manually calculating from spreadsheets, they ask their agent to run `list_timeghost_projects`. The agent replies with 80% utilization and a link to the detailed health metadata for immediate review. ### Onboarding New Team Members The HR Admin needs to know who has access to which resources. They ask the agent to use `list_timeghost_members` and then `list_timeghost_workspaces`. This instantly generates a clear list of team roles and organizational settings for onboarding documentation. ### Investigating Missing Hours A Team Lead suspects an employee forgot to log time. They ask the agent to use `list_timeghost_entries`, filtering by the user's name and a specific date range. The agent provides the logs, helping the lead identify gaps in productivity. ### Project Scope Check A developer needs to ensure they are working on the right thing. They ask the agent to list tasks filtered by the project ID (`list_timeghost_tasks`). The agent returns a clear, technical pipeline view of all current assignments. ## Benefits - See the full picture of resource allocation. Instead of opening ten tabs to check budgets, just ask the agent to use `list_timeghost_projects` and get a consolidated view of all active projects and their budget health. - Stop tracking time manually. By using `list_timeghost_entries`, you can pull records filtered by date range or user name, giving your team instant visibility into who worked on what when. - Keep task pipelines organized. If you need to know the details for a specific piece of work, run `get_timeghost_task` and get all technical metadata tied directly to that assignment. - Never lose context again. The agent can use `list_timeghost_members` to confirm who was on the team before generating any time log or project report. - Audit your setup quickly. Use `check_timeghost_status` to verify API connectivity immediately, so you don't waste time running queries that fail halfway through. ## How It Works The bottom line is, you give your agent the credentials, and it handles all the data fetching from Microsoft 365. 1. 1. Subscribe to this server on Vinkius. 2. 2. Copy your API Token from your timeghost account (Settings > API Keys). 3. 3. Provide the token to your AI client and ask a direct question, like: 'List all active projects.' ## Frequently Asked Questions **How do I check my API connection status using timeghost MCP Server?** Run `check_timeghost_status`. This tool immediately confirms if your credentials are working and if the server can access your Microsoft 365 data streams. It's a quick test before you run anything big. **Can I list all projects in timeghost MCP Server?** Yes, use `list_timeghost_projects`. This tool gives you an immediate directory of every project and its current budget utilization percentage, helping you spot scope creep right away. **What if I only want to see time entries for one user?** Use `list_timeghost_entries`. You can filter the results by a specific username or collaborator ID, narrowing down the log data fast. This is perfect for payroll audits. **How do I find out who was on the team?** Run `list_timeghost_members`. This tool fetches all workspace members and collaborators, giving you a complete roster of people associated with your accounts. **What is required to authenticate my connection using the timeghost API?** You must provide an API Token generated within your timeghost account settings. This token authorizes your AI client to access and manipulate your data. You'll need this string when setting up the initial connection. **What technical metadata does get_timeghost_project return?** The tool provides detailed project health metrics, including budget utilization percentages and resource assignments. This means you don't just get a name; you get actionable data on the project's current standing. **Are there performance limits when calling list_timeghost_entries?** Yes, API usage is governed by rate limits set by timeghost. If you run large queries, it's best practice to batch your requests or filter by specific date ranges to avoid hitting service caps. **How do I understand my full organizational setup using list_timeghost_workspaces?** This tool retrieves a complete profile of all associated workspaces. It helps you map out your company's structure, showing where different projects and teams are housed within the larger Microsoft 365 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.