# ProofHub MCP for AI Agents AI Agent Connect

> ProofHub MCP lets your AI agent manage projects, tasks, and team collaboration in real-time. It handles everything from creating new to-dos and listing active projects to auditing timesheets and reading team discussions. Instead of switching tabs, you can ask your agent to pull progress reports or update task statuses directly from your chat interface.

## Overview
- **Category:** project-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_NHakRDnW1E7PH48Ok9QlJqpS9ap91HfgQwbnyEiB/ai-agent-connect
- **Tags:** task-management, team-collaboration, time-tracking, document-management

## Description

Managing a project usually involves jumping between different tabs to check what's done, who's working on what, and where the latest files are. This Connector changes that by putting your ProofHub data right into your chat interface. You can ask your agent to pull up a project overview or find specific tasks in a list without leaving your current workspace. It handles the heavy lifting of digging through project boards, so you can focus on making decisions rather than hunting for information. Since Vinkius hosts this, you can connect it to your favorite client and have your agent start handling the busy work of updating to-dos, auditing logged hours, and summarizing team discussions. It's about making your project management tools actually work for you while you stay focused on the big picture.

## Tools

### list_projects
See every project in your ProofHub account at once. This helps you get an overview of all active work.

### get_project
Get every detail for a specific project. This includes status, metadata, and other core project info.

### list_todolists
Find the correct list ID for your project. This is a necessary step before you can query or create specific tasks.

### list_tasks
See all tasks within a specific to-do list. Use this to check what's pending or completed.

### create_task
Add a new task to a project list by providing the project and list IDs. This lets you update work items instantly.

### list_discussions
Read all the topics and conversations happening in a project. This keeps you in the loop on team feedback.

### list_files
See every file uploaded to a project for quick access to docs. This helps you find resources without digging through folders.

### list_timesheets
Pull all logged hours for a project to check team productivity. This helps you audit time spent on specific deliverables.

### list_people
Get a list of all team members currently in your ProofHub. This is useful for checking who is assigned to a project.

### list_notes
Find all notebooks and notes saved within a project. Use this to pull up shared documentation and project history.

## Prompt Examples

**Prompt:** 
```
What projects are we currently working on?
```

**Response:** 
```
You currently have 4 active projects in ProofHub:

| Project Name | ID | Status |
| :--- | :--- | :--- |
| Q4 Marketing Campaign | 102 | In Progress |
| Website Overhaul | 105 | Planning |
| Mobile App Beta | 108 | On Hold |
| Internal Audit | 110 | Completed |

Would you like to see the task list for any of these?
```

**Prompt:** 
```
List the pending tasks for the website overhaul.
```

**Response:** 
```
Here are the pending tasks for the **Website Overhaul** project:

*   Optimize hero images
*   Fix CSS spacing on mobile
*   Write FAQ section
*   Update privacy policy

I can create a new task for you if you need to add anything else.
```

**Prompt:** 
```
Who is on the team and what's the latest discussion?
```

**Response:** 
```
The team for this project includes:
*   **Alex Rivera** (Lead)
*   **Jordan Smith** (Dev)
*   **Taylor Reed** (Design)

**Recent Discussions:**
*   "Feedback on the new landing page hero section" (3 replies)
*   "Discussion on API integration delays" (1 reply)
*   "Finalizing the color palette for the beta launch" (5 replies)
```

## Capabilities

### Pull project overviews
Get metadata and status for any active project instantly.

### Create new tasks
Add new work items to specific to-do lists on the fly.

### Audit team timesheets
Check logged hours and team productivity for any project.

### Read project discussions
See what your team is saying in project topics and threads.

### List team members
See who is currently assigned to your projects.

### Find shared files
Locate documentation and uploaded files within a project.

## Use Cases

### Instant Status Updates
A project manager asks 'What's the status of the website overhaul?' and the agent pulls the project overview and pending tasks using list_tasks.

### Quick Team Onboarding
A new hire asks 'Who is on the team?' and the agent uses list_people to show the full roster and assigned roles.

### Meeting Follow-ups
After a call, a lead says 'Create a task for the dev team to fix the login bug' and the agent adds it to the correct list using create_task.

### Resource Auditing
A manager asks 'How many hours did we spend on the marketing campaign last week?' and the agent pulls the timesheets using list_timesheets.

## Benefits

- Stop hunting for task statuses by using list_tasks to get instant updates on what's pending.
- Update your project plan faster by using create_task to add work items while you're still in the middle of a conversation.
- Get a clear view of team effort by using list_timesheets to pull logged hours without opening the payroll tab.
- Stay in the loop on team feedback by using list_discussions to see what people are saying about specific projects.
- Locate project resources quickly by using list_files and list_notes to find documentation in seconds.
- Reduce context switching by pulling project overviews directly into your workspace instead of clicking through dashboards.

## How It Works

The bottom line is your AI agent becomes a project management assistant that actually knows what's going on in ProofHub.

1. Subscribe to the ProofHub MCP on Vinkius.
2. Provide your ProofHub Domain and API Key in your client settings.
3. Ask your agent to fetch tasks, create to-dos, or summarize project notes.

## Frequently Asked Questions

**Can the ProofHub MCP create tasks for my team?**
Yes, it can add new tasks to your lists directly. You can ask your agent to create a task based on a conversation or a note, and it will appear in ProofHub instantly.

**How do I use ProofHub MCP to check team hours?**
The Connector pulls timesheet data so you can see how many hours have been logged on a project. It's a great way to audit productivity without opening the payroll or time-tracking tabs.

**Does ProofHub MCP work with my current AI client?**
Yes, it works with any MCP-compatible client like Claude, Cursor, or Windsurf. Once connected via Vinkius, your agent can access all your ProofHub data.

**Can I see project files using ProofHub MCP?**
Yes, it can list all files uploaded to a specific project. This allows your agent to help you find documentation or shared assets quickly.

**How do I get my project status without opening ProofHub?**
When you ask your agent for a project overview, it pulls the latest status and metadata from ProofHub. You get a summary in your chat instead of having to visit the website.

**Can ProofHub MCP help with remote team collaboration?**
Definitely. It allows your agent to read project discussions, notes, and team member lists, making it much easier to stay aligned with a remote team.

**How do I connect my account?**
Subscribe and provide two things: your **ProofHub Domain** (the 'mycompany' part of `mycompany.proofhub.com`) and your **API Key**. The API Key is somewhat hidden: log into ProofHub, click your profile picture in the bottom-left corner 5 times straight to reveal the 'API access' option, then generate or copy your key.

**Can my agent create tasks directly?**
Yes! Just tell your agent the project name (or ID), the to-do list, and the title of the task you want created. It will use the `create_task` tool to instantly drop that work item into the specified ProofHub list for your team to pick up.

**How can I see what the team has been discussing?**
Ask your agent to 'list discussions for project X'. It retrieves all recent discussion topics securely, allowing you to stay in the loop on project blockers, decisions, and brainstorming without opening multiple communication tabs.

**Can this server pull files and notes?**
Yes. Beyond tasks, the agent can query both `list_files` and `list_notes` for any given project ID. If someone uploaded project requirements or drafted meeting notes, your AI assistant can surface their metadata and context on demand.