# Height MCP for AI Agents AI Agent Connect

> Height (Project Management) MCP connects your Height workspace to your AI client. It lets you query tasks, manage lists, and audit team activity through natural conversation. Instead of clicking through the UI, you can ask your agent to pull up specific task details, list out project milestones, or check who's working on what.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_rS099BpgmcYdwg9cfbBmWd7n8S75AZRfzrV9Uq0O/ai-agent-connect
- **Tags:** task-tracking, workflow-automation, team-collaboration, project-planning, task-management, workspace-organization

## Description

Managing a project usually means jumping between tabs, filtering lists, and hunting for specific task updates. This Connector changes that by bringing your Height data directly into your AI's context. You can ask your agent to pull up a list of overdue tasks or check the latest activity on a specific project milestone without ever opening a browser. It's a way to keep your head in the work while the agent handles the data fetching. Since Vinkius hosts this Connector, you can get it running in your favorite AI client in minutes. You'll be able to map out your team's identities, audit workspace domains, and keep your project organization tight by managing high-level lists and grouping constructs through simple prompts. It's about making your project management data actionable where you're already working.

## Tools

### workspace
Retrieve the primary workspace information. It gives your agent the necessary context for your account.

### list_tasks
Fetch a list of tasks from your project. This is the go-to tool for seeing what needs to be done.

### get_task
Pull specific details for a single task. It shows you the status, priority, and description in one go.

### list_lists
See all the lists and groups in your workspace. Use this to navigate your project's high-level organization.

### list_users
Get a list of all users registered in your Height workspace. It helps you identify team members quickly.

### list_activities
View the audit trail of actions taken within your workspace. Use this to see recent changes and updates.

## Prompt Examples

**Prompt:** 
```
What are the current blockers for the 'Security Audit' task?
```

**Response:** 
```
I've checked the 'Security Audit' task (T-108). It is currently marked as **Blocked**. The last note from the team mentions a delay in getting the core infrastructure credentials. Would you like me to list the activities for this task to see who reported it?
```

**Prompt:** 
```
List all tasks in the 'Product Roadmap' list.
```

**Response:** 
```
I found 8 tasks in the 'Product Roadmap' list. Here are the highlights:

* **API V2 Release** (T-102)
* **User Onboarding Flow** (T-105)
* **Security Audit** (T-108)

Let me know if you want to see the full list or specific details on any of these.
```

**Prompt:** 
```
Who is currently on the team and what's our workspace setup?
```

**Response:** 
```
Your workspace is active with the following team members:

* **Alex**
* **Sarah**
* **Mark**
* **Jordan**

Your workspace is currently organized into 4 main lists: **Product Roadmap**, **Bug Fixes**, **Infrastructure**, and **Design Specs**.
```

## Capabilities

### Pull task details
Get full metadata and status for any specific task instantly.

### Audit activity logs
See the history of changes and status mutations for any task.

### Map team members
Fetch and identify registered users across your organization.

### Manage workspace lists
Organize and discover high-level grouping constructs.

### Query task lists
Retrieve full lists of tasks to see what's on the horizon.

## Use Cases

### The status update
A PM asks 'What's the status of the API migration?' and the agent uses get_task to summarize the current blockers.

### The dev flow
A developer wants to see their assigned work in Cursor and asks the agent to list tasks from their specific list.

### The workspace audit
An admin needs to check who has access and what's happening, so they use list_users and list_activities.

### The project kickoff
A lead wants to see the high-level structure and uses list_lists to understand the project's grouping.

## Benefits

- Stop context switching by pulling task details from Height directly into your AI client or IDE.
- Get instant status updates by using list_tasks to see what's pending without opening a browser.
- Audit project history easily by using list_activities to see every status change and comment.
- Identify team members quickly using list_users to map out who is responsible for specific work.
- Keep your workspace organized by using list_lists to manage high-level grouping constructs.
- Save time on reporting by asking your agent to summarize task metadata from get_task.

## How It Works

The bottom line is you get to manage your entire Height project board using only natural language.

1. Subscribe to the Height MCP on Vinkius.
2. Provide your Height API Key in the connection settings.
3. Ask your AI client to list tasks or check project status.

## Frequently Asked Questions

**How does the Height MCP help with project management?**
It lets you query your project data using natural language. You can ask your agent to find tasks, check statuses, or summarize project progress without leaving your current app.

**Can I use the Height MCP to see task history?**
Yes. You can ask your agent to pull up the activity logs for any specific task to see who made changes and what those changes were.

**Does the Height MCP work with Cursor or Claude?**
Yes. It works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

**How do I get my team list into my AI agent?**
Once connected, your agent can use the list_users tool to show you everyone registered in your workspace and their roles.

**Can I use the Height MCP to audit workspace activities?**
Absolutely. It allows your agent to fetch activity logs, making it easy to audit changes and monitor team movements across the workspace.

**How do I connect my Height account to Vinkius?**
Just subscribe to the Connector on Vinkius and enter your Height API Key in the configuration settings to link your workspace.

**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.