# Height MCP > Height MCP Server manages your projects and tasks. Use it to list, retrieve, and track tasks, manage workspace lists, and audit project activities directly through your AI agent. You can fetch full metadata on specific tasks, discover high-level grouping constructs, and track activity logs for any project element. It gives your AI agent full control over your project management data. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** task-tracking, workflow-automation, team-collaboration, project-planning, task-management, workspace-organization ## Description Height manages your projects and tasks. You'll use this server to list, retrieve, and track tasks, manage workspace lists, and audit project activities straight through your AI agent. You can grab full metadata on specific tasks, discover high-level grouping constructs, and track activity logs for anything in the project. It gives your AI agent total control over your project management data. **Get Task Details**: You'll use `get_task` to pull the full metadata and structural details for any specific task ID. **Track Activity Logs**: `list_activities` lets you pull the historical activity records for a task, showing every status change and comment. **Discover Lists and Groups**: You can run `list_lists` to pull the names and structures of organizational lists or grouping containers. **List All Tasks**: `list_tasks` fetches a list of tasks across the workspace, letting you view multiple items in a single request. **Find Team Members**: You'll use `list_users` to pull a map of registered users and team members in the workspace. **View Workspace Context**: The `workspace` tool gets the core structural information for the entire domain you're working in. ## Tools ### get_task Retrieves the full metadata and details for a specific task. ### list_activities Lists the recent activity logs and audit trail for a given task. ### list_lists Retrieves the names and structures of organizational lists or grouping containers. ### list_tasks Fetches a list of tasks, allowing you to view multiple items in a single request. ### list_users Retrieves a map of registered users and team members associated with the workspace. ### workspace Gets core structural information about the entire workspace domain. ## Prompt Examples **Prompt:** ``` List all tasks in my 'Product Roadmap' list ``` **Response:** ``` I've found 8 tasks in the 'Product Roadmap' list. Highlights include 'API V2 Release' (T-102), 'User Onboarding Flow' (T-105), and 'Security Audit' (T-108). Would you like the details for any of these? ``` **Prompt:** ``` Show me the recent activity for task T-102 ``` **Response:** ``` Recent activity for T-102 ('API V2 Release'): Status changed from 'In Progress' to 'Review' by Alex. Sarah added a comment: 'Endpoint documentation is complete'. Would you like to see earlier history? ``` **Prompt:** ``` What are the details for task T-108? ``` **Response:** ``` Task T-108 ('Security Audit'): Assigned to Mark, Priority: High, Due Date: Next Friday. Description: 'Complete the quarterly security audit for the core infrastructure'. Current status: 'Blocked'. ``` ## Capabilities ### Get Task Details Retrieves the full metadata and structural details for a specific task ID. ### Track Activity Logs Lists the historical activity records for a task, showing status changes and comments. ### Discover Lists and Groups Retrieves high-level grouping structures and lists within your workspace for organization. ### List All Tasks Fetches a list of tasks across the workspace, allowing bulk viewing and filtering. ### Find Team Members Retrieves and maps user identities and details of registered teammates in the organization. ### View Workspace Context Gets core details about the entire workspace domain you are working in. ## Use Cases ### Need a status report on a sprint. A Project Manager needs to know if the 'API V2' task is blocked. They prompt their agent: 'What's the status of API V2 and who last touched it?' The agent runs `get_task` and `list_activities`, synthesizing the results to show the status change history and the responsible party, giving the PM a real-time summary. ### Onboarding a new team member. An Operations Analyst needs to verify who can access the workspace. They ask the agent to 'List all current users and their roles.' The agent uses `list_users` to pull the roster, ensuring the new hire gets access to the correct, up-to-date user group. ### Investigating a project bottleneck. A Developer finds a task ID but can't see the full context. They ask the agent to 'Show me all details for task T-108.' The agent runs `get_task`, pulling the full description, assigned person, priority, and due date, all in one chat response. ### Mapping project scope. A PM needs to understand the project structure. They ask the agent to 'What are the main sections of the project?' The agent uses `list_lists` to map out the major grouping constructs, providing a high-level view before diving into individual tasks. ## Benefits - See the full history of any task using `list_activities`. You instantly track status changes and comments without navigating to a separate audit log page. - Build status reports instantly. By combining `list_tasks` and `list_users`, your agent pulls current assignments and status across the entire project roster. - Keep context local. Developers can run `list_tasks` right in their IDE to inspect task details, eliminating the need to switch tabs or leave their coding environment. - Audit the setup. Use the `workspace` tool to extract the explicit domain and user credentials linked to your account for quick, structured audits. - Organize the view. The `list_lists` tool lets you discover and map out the high-level groupings, giving you a clear picture of the entire project structure. - Map the team. Run `list_users` to fetch a secure map of all registered teammates and user identities across the organization. ## How It Works The bottom line is, your agent talks to Height using structured API calls, and you get the data back instantly for analysis. 1. Subscribe to the server and input your specific Height API Key. 2. Your AI client initiates a request using a tool name (e.g., `list_tasks`). 3. The server executes the tool call against your Height account and sends the structured data back to your agent. ## Frequently Asked Questions **How do I use the Height MCP Server to check task history?** You use the `list_activities` tool. This tool retrieves the full audit trail for a specific task, showing who changed the status and when. It's useful for accountability and debugging project flow. **Can I list all tasks in a specific list?** Yes, you first use `list_lists` to confirm the list ID, and then the agent uses `list_tasks` to pull all tasks contained within that specific grouping. **What is the best way to find out who is on the project?** The `list_users` tool gives you a complete roster of all registered teammates and their identities, which is better than just looking at the task assignment fields. **Do I need to use the `workspace` tool first?** It's good practice. Running `workspace` confirms the domain context of your project. This ensures that subsequent calls to `list_tasks` or `list_lists` are scoped to the correct project area. **How do I use the `list_users` tool to check team roles?** The `list_users` tool fetches user identities and roles. It shows who's on the team, including their assigned roles and credentials within the Height workspace. **What is the best way to use the `list_activities` tool for auditing?** The `list_activities` tool provides a full audit trail. You can track how a task's status changed or who added a comment, giving you a complete history of state changes. **Does the `get_task` tool require specific IDs?** Yes, the `get_task` tool needs the task ID to pull details. This ensures you get the precise, up-to-date metadata for a single task instance. **Can the `list_tasks` tool handle filtering by a specific list?** The `list_tasks` tool supports filtering by lists. You just need to specify the target list name, and it pulls all associated tasks for you. **Can I see the full history of a task through my agent?** Yes. Use the `list_activities` tool with a specific Task ID to retrieve the full audit trail, including state changes and comments, ensuring you never miss the context of a task's evolution. **How do I find a specific task ID?** You can use `list_tasks` to browse tasks within a workspace or list. Your agent will display the Task IDs along with their names, making it easy to identify the exact task you need to inspect. **Can I list all members of my workspace?** Absolutely. The `list_users` tool allows you to fetch all registered teammates in your Height workspace, helping you map assignments and identify collaborators in your projects.