# Forecast MCP

> Forecast MCP gives your AI agent full control over resource management in Forecast.app. List every project, check task statuses, find out who's available this week, and track milestones—all through natural conversation. Stop jumping between dashboards and get a real-time view of team capacity and project health.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** resource-management, capacity-planning, project-scheduling, time-tracking, financial-forecasting

## Description

Managing resources shouldn't feel like juggling six different dashboards. This MCP connects your AI agent directly to Forecast.app, letting you manage every detail about your projects without ever copying an ID or digging through menus. You simply ask your agent questions like, 'Who is available next Tuesday?' or 'What milestones are due for the API V2 project?' The system instantly pulls all that data together. If you're using a different type of integration—say, just connecting to basic task trackers—you'll only get a list of tasks. With this MCP, you get the full picture: client relationships tied to projects, specific resource assignments, and accurate milestone dates. Connecting through Vinkius gives you access to Forecast’s entire library of data, letting your agent handle project orchestration right from your chat window.

## Tools

### list_milestones
Identifies specific time markers or goals that are set for the project timeline.

### list_projects
Generates a list of all currently managed projects in your system.

### get_project
Fetches complete, detailed information about one specific project ID.

### list_tasks
Lists all tasks associated with a given project, showing their completion status.

### list_people
Returns a list of team members and their current capacity or availability constraints.

### list_clients
Retrieves a list of all clients mapped to your projects.

## Prompt Examples

**Prompt:** 
```
List all active projects in Forecast
```

**Response:** 
```
Retrieving projects... I found 5 active projects: 'Q2 Marketing Launch', 'API V2 Development', 'Client Dashboard Refactor', 'Security Audit', and 'New Website Build'. Which one would you like to see the tasks for?
```

**Prompt:** 
```
Show me the tasks for project 'API V2 Development'
```

**Response:** 
```
Retrieving tasks for 'API V2 Development' (ID: 123)... I found 10 tasks including 'Define Auth Schema' (In Progress), 'Implement Webhooks' (Todo), and 'Rate Limiting Logic' (Done). Would you like to see the assignee for the auth schema task?
```

**Prompt:** 
```
Who is available this week for a new assignment?
```

**Response:** 
```
Checking team availability... John and Sarah have 10+ hours of open capacity this week. Mike and Alice are currently fully booked on the Marketing project. Would you like me to assign a new task to Sarah?
```

## Capabilities

### View all active projects
Get a global list of every managed project and its current status.

### Audit task completion
Check specific tasks assigned to any project, identifying bottlenecks or delays instantly.

### Determine team availability
Fetch the current capacity and workload limits for global team members.

### Map client connections
See which specific clients are linked to active projects within your account.

### Track project deadlines
Identify key time markers or milestones that define the boundaries of a deliverable target.

## Use Cases

### The quarterly review is coming up, and I need to know if we hit our targets.
Instead of opening the main dashboard, you prompt your agent: 'Show me all milestones for Q3.' The MCP uses list_milestones to confirm which critical deadlines are currently within active boundaries.

### I need to assign a new feature, but I don't know if anyone has bandwidth.
You ask: 'Who is available this week?' The agent uses list_people to check capacity and immediately tells you which team members have open hours, so you can proceed with confidence.

### We just onboarded a new client, and I need to link them to the right internal project.
You prompt: 'What projects are linked to Client XYZ?' The agent runs list_clients and correlates that data with active projects, ensuring you manage stakeholder communication correctly from day one.

### I'm prepping for a pitch meeting and need an overview of the scope.
You ask the agent to get project details. It uses get_project to pull all necessary data—tasks, associated people, client names, and milestones—into one readable summary.

## Benefits

- Stop manually checking dashboards for task progress. You can ask your agent to list tasks directly for a project ID, immediately telling you if work is stuck or done.
- Never overbook a team member again. Use the MCP to list people and check their current availability constraints instantly, ensuring resource allocation stays balanced.
- Get context on who you're talking to. The agent can list clients and map them to specific projects, keeping your stakeholder communications perfectly organized.
- Monitor project timelines without stress. By listing milestones, you always know the exact time boundaries for critical deliverables, so nothing slips through the cracks.
- Understand the whole scope of a project by using get_project. It gathers all details—from associated tasks to client names—into one cohesive answer.

## How It Works

The bottom line is you tell it what you need in plain English, and it brings back the structured project status report.

1. Subscribe to this MCP and provide your Forecast Personal API Key.
2. Connect your preferred AI client (like Claude, Cursor, etc.) to Vinkius.
3. Ask your agent a question about your projects. It uses the tool access to pull live data directly from Forecast.

## Frequently Asked Questions

**How does the list_projects tool work with other tools?**
You can first use list_projects to get a high-level overview of all projects. Then, you pass that specific project ID to get_project or list_tasks to drill down into details for that one area.

**Can I check team availability with the Forecast MCP?**
Yes, use list_people. This tool checks global member capacity and workload limits so you know exactly who is free before assigning work.

**Does this MCP help me manage client relationships?**
Absolutely. You can use list_clients to get a full roster of clients, and the agent helps map them back to specific projects in your account.

**What if I need project details that span multiple months?**
Use list_milestones. This tool identifies key time markers for deliverables, helping you track progress against set targets regardless of the overall timeline length.

**Is this MCP better than just exporting data from Forecast?**
Yes. Exporting gives static data; this MCP gives live, conversational access to that data. The agent answers questions immediately rather than giving you a spreadsheet to parse.

**Can my agent list all active projects in Forecast?**
Yes. Use the 'list_projects' tool. The agent will retrieve the global array of all managed projects mapped inside your Forecast account, including their names and unique IDs.

**How do I check a specific team member's availability via chat?**
Use the 'list_people' tool. Your agent will fetch the physical identity definitions and availability constraints of global members, allowing you to monitor team utilization and workload natively.

**Can I see the upcoming milestones for a project through the agent?**
Absolutely. Use the 'list_milestones' tool with the specific Project ID. The agent will identify timebox markers bounding specific sprint or deliverable targets for that project natively.