# ProjectFlow MCP Server

This is the official [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for ProjectFlow. It allows AI coding agents (like Claude Desktop, Antigravity, Cursor, etc.) to securely read, update, and create tasks on your ProjectFlow boards.

## Installation

Any user can install this globally using pip:

```bash
pip install projectflow-mcp
```

## Configuration (For Users)

Once installed, users just need to add this server to their AI agent's configuration file.

### For Claude Desktop & Antigravity

Add the following to your `claude_desktop_config.json` (or `mcp_config.json` for Antigravity):

```json
{
  "mcpServers": {
    "projectflow": {
      "command": "projectflow-mcp",
      "env": {
        "PROJECTFLOW_EMAIL": "your-email@example.com",
        "PROJECTFLOW_PASSWORD": "your-password",
        "PROJECTFLOW_API_URL": "https://projectflow.thuthuka.tech/api"
      }
    }
  }
}
```

*Note: The `PROJECTFLOW_API_URL` defaults to the main production URL if not provided.*

## Available AI Tools
When connected, your AI gains the following capabilities:

### Tasks & Projects
* `list_projects`: Discover available workspaces and projects.
* `list_my_tasks`: View assigned tasks and current board status.
* `get_task_details`: Fetch subtasks and deep descriptions.
* `update_task_status`: Move tasks to `TODO`, `IN_PROGRESS`, or `DONE`.
* `create_task` / `create_subtask`: Allow the AI to log bugs or break down its own work.
* `assign_task`: Assign a task to a teammate by email.
* `add_project_member` / `remove_project_member`: Manage who's on a project.
* `list_milestones` / `create_milestone`: Track project milestones.
* `log_time_entry` / `list_time_entries`: Log and review time spent on tasks.
* `send_task_reminder` / `remind_overdue_tasks`: Nudge assignees about due/overdue work.

### Chat & Notifications
* `list_conversations`: List your DMs and project channels.
* `get_project_channel`: Get (or create) a project's chat channel.
* `start_direct_message`: Start/resume a DM with a teammate.
* `list_messages`: Read messages in a channel, DM, or a task's comment thread.
* `post_message`: Post a message or task comment, with optional @mentions.
* `search_chat_references`: Find tasks/projects to `#`-reference in a message.
* `list_notifications` / `mark_notification_read` / `mark_all_notifications_read`: Manage your notification inbox.

### Search
* `search_users`: Find a teammate's exact email by name/email search.
* `global_search`: Search across workspaces, projects, and tasks.