# Nozbe MCP

> Nozbe connects your team's project management directly to your AI agent. You can list projects, create new tasks, update priorities, and track group collaboration right from your chat interface. This server lets you manage complex workflows without switching apps or navigating away from where you are working.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** task-management, team-collaboration, priority-tracking, project-lists, workflow-coordination

## Description

You're dealing with projects and tasks in Nozbe? Don't jump between tabs and dashboards—you just talk to your agent and get it done right here. This server lets you manage complex workflows without ever leaving the chat window.

**Managing Your Projects**

The system knows what groups of work you have going on. You can use **`list_projects`** to pull up a rundown of every project accessible to your account, giving you an immediate overview of your team's scope. Need to start something new? Just call **`create_project`**, and it sets up a brand-new container for all the related tasks and effort your team needs to track.

To get granular, you can run **`get_project`** by providing a specific project ID; that pulls every single detail about that project's full scope. You'll find the whole picture in one go.

**Handling Tasks Day-to-Day**

This is where you actually get stuff done. To see what needs attention, run **`list_tasks`**, and it shows all tasks associated with your team or department that are visible right now. If you know exactly which task you mean, use **`get_task`** by its unique ID; that retrieves the current status, who owns it, and the full description of that individual item.

You've got an update? You don't have to email someone. Use **`update_task`** to modify details instantly—you can change the assignee, switch the status, or adjust a due date for any task you reference. When a task is done for good or just plain irrelevant, you use **`delete_task`**, and it permanently removes that item from the system.

To track conversations around an assignment, run **`list_comments`** on a specific task; this pulls up every discussion comment attached to it, giving you the full history before you reply. You'll also want to check who you are using **`get_me`**, which confirms your current user identity and makes sure the connection is working right.

**Understanding Your Team Structure**

Knowing who's on what team is key. To see all available teams you belong to, run **`list_teams`**. If you need deep background on a specific group, use **`get_team`**; that pulls detailed information about the team, letting your agent know exactly who's in it and what its scope is.

## Tools

### create_project
Sets up a new container for related tasks and team efforts within Nozbe.

### create_task
Adds a brand-new, actionable item to an existing project or team list.

### delete_task
Permanently removes a task from the system after it is completed or deemed irrelevant.

### get_me
Confirms your current user identity and checks if the server connection is working correctly.

### get_project
Pulls all the details for a specific project ID, giving you its full scope.

### get_task
Retrieves the current status, owner, and description of an individual task by its unique ID.

### get_team
Gets detailed information about a specific team to verify membership or scope.

### list_comments
Fetches all discussion comments attached to a task, letting you see the conversation history.

### list_projects
Provides a list of every project accessible to your account.

### list_tasks
Shows all tasks associated with your team or department that are visible in the system.

### list_teams
Lists all available teams you're a member of within Nozbe.

### update_task
Modifies an existing task—you can change the assignee, status, or due date.

## Prompt Examples

**Prompt:** 
```
List all my priority tasks for today.
```

**Response:** 
```
You have 3 priority tasks: 'Finish quarterly report', 'Review marketing copy', and 'Email client'.
```

**Prompt:** 
```
Create a task 'Update website banner' and assign it to Sarah.
```

**Response:** 
```
Task 'Update website banner' created and successfully assigned to Sarah.
```

**Prompt:** 
```
Mark task ID 5402 as completed.
```

**Response:** 
```
Task 5402 has been marked as completed. Great job!
```

## Capabilities

### Manage Projects
You can call `create_project` to set up a whole new project container or use `list_projects` to see everything accessible.

### Handle Tasks
Need to adjust something? You can run `update_task` to change details, assign ownership, or even call `delete_task` when a task is done for good.

### Track Team Structure
Use the team tools (`list_teams`, `get_team`) so your agent knows who you're talking to and what groups exist.

### Retrieve Context
The server lets you pull specific data using `get_project` or `get_task` to feed context back into the chat conversation.

### Review Discussions
You can run `list_comments` on a task, pulling up the full discussion history for context before responding.

## Use Cases

### The sprint planning sync-up
A tech lead needs a quick overview of what was supposed to happen. Instead of opening three different project views, they prompt their agent: 'List all tasks in the API redesign project that are due this week.' The agent runs `list_tasks` and filters them by date, giving the team an immediate, clean list for review.

### The missed dependency check
A product manager notices a task is stalled. They ask their agent to 'Check why Task ID 5402 hasn't moved.' The agent runs `get_task` and then automatically calls `list_comments`, showing the PM exactly where the conversation stopped, solving the mystery immediately.

### Onboarding a new team member
The manager needs to assign a bulk of work. They prompt: 'Create a project for Q3 marketing and add three tasks under it.' The agent runs `create_project` first, then uses `create_task` multiple times, setting up the entire structure in one conversational turn.

### The overdue assignment update
A team member finished a task but forgot to mark it. They ask: 'Mark Task ID 5402 as done.' The agent runs `update_task`, changing the status and logging the completion, keeping the board clean without manual clicks.

## Benefits

- Stop context switching. Instead of jumping to Nozbe, then back to Slack, you run `list_tasks` directly in the conversation thread. Your agent brings the data to you, saving time.
- Maintain a single source of truth for project status. You can check an item's current status by running `get_task`, eliminating the need to open the full dashboard just to verify one due date.
- Coordinate ownership quickly. When something changes hands, use `update_task` via your agent. You don't have to copy-paste details; you just tell the AI client to assign it to someone else.
- See the whole story on any item. Running `list_comments` for a specific task pulls up the full discussion history, ensuring nobody misses key context or decision points.
- Scope out your work instantly. Use `list_projects` and then `get_project` to map out all the existing containers you're working in before starting any new tasks.

## How It Works

The bottom line is that your AI client talks to Nozbe's API tools and presents the results like natural conversation.

1. Tell your agent what you need to do. For example: 'List all projects related to Q3 marketing.'
2. The agent recognizes the intent and runs the appropriate tool, like `list_projects`, sending it data requests via MCP.
3. The server returns a structured list of projects or tasks, which the agent then formats into plain text for you in the chat.

## Frequently Asked Questions

**How do I list all accessible projects using Nozbe's MCP Server?**
Run `list_projects` with your agent. This tool pulls a comprehensive list of every project container you have access to, giving you an immediate overview of the organization’s scope.

**What is the difference between `get_task` and `update_task` in Nozbe?**
`get_task` retrieves data—it shows you the current status, owner, etc. `update_task` actually changes something; it's how you change the status or assignee of an existing task.

**Can I create a project and tasks at the same time with Nozbe?**
You typically run these commands sequentially via your agent. First, use `create_project` to set up the container, then follow up by using `create_task` within that new project's context.

**Does Nozbe’s MCP Server track team members?**
Yes, you can run `list_teams` or `get_team`. These tools let your agent retrieve details about the teams and specific users involved in the project scope.

**What happens when I use the `delete_task` tool?**
The task is permanently removed from Nozbe. You must confirm the exact Task ID before calling this function, as there's no undo feature for deletion.

**How do I get discussion comments using `list_comments`?**
This tool pulls all historical discussion threads tied to a specific task. It lets your AI agent see the full context of conversations without having to navigate the Nozbe interface.

**What information does running the `get_me` tool provide?**
It validates your API connection and returns essential user context data, confirming that your current agent has the necessary permissions for Nozbe.

**Are there any performance limits when using `list_projects`?**
If you have a very large number of projects, the system may paginate results or impose rate limits. For best performance, break down massive requests into smaller batches.

**Can I retrieve all tasks from a specific project?**
Yes, just provide the project name or ID, and the agent will list all active and completed tasks within it.

**How do I assign a task to a team member?**
You can tell the AI to create a task and mention the assignee, and the integration will route the task to them in Nozbe.

**Is it possible to complete a task directly?**
Absolutely. By providing the task ID to the agent, you can mark it as completed instantly.