# Nozbe Teams — how to use (mcp.ai)

Connect your Nozbe Teams account and use 48 tools for task management straight from your AI agent. Connect with your own API key. Cloud-based task management tool helping individuals and teams get organized.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_nozbe_teams?ms=1787293620000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `nozbe_teams_create_attachment`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/nozbe_teams`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/nozbe_teams/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/nozbe_teams/create/attachment` — Tool to add attachment metadata to a comment. Use when you need to create attachment metadata for a file associated with a comment. This creates the metadata record; actual file upload may be a separa
  - body: { name: string, mime_type?: string, comment_id: string }
- `POST https://api.mcp.ai/api/nozbe_teams/create/comment` — Tool to add a comment to a task in Nozbe Teams. Use when you need to add feedback, notes, or updates to a specific task.
  - body: { body: string, is_team?: boolean, task_id: string, is_pinned?: boolean }
- `POST https://api.mcp.ai/api/nozbe_teams/create/project/section` — Tool to create a new project section in Nozbe Teams. Use when you need to add a section to organize tasks within a project.
  - body: { name: string, position?: number, project_id: string }
- `POST https://api.mcp.ai/api/nozbe_teams/create/reminder` — Tool to add a reminder to a task in Nozbe Teams. Use when you need to set up a notification for a specific task at a given time.
  - body: { task_id: string, remind_at: integer, is_all_day: boolean, is_relative: boolean }
- `POST https://api.mcp.ai/api/nozbe_teams/create/tag/assignment` — Tool to add a tag assignment to a task. Use when you need to tag or label a task for organization or categorization purposes.
  - body: { tag_id: string, task_id: string }
- `POST https://api.mcp.ai/api/nozbe_teams/create/task` — Tool to create a new task in Nozbe Teams. Use when you need to add a task to a project or personal task list. Only the task name is required; all other fields are optional.
  - body: { name: string, due_at?: integer, is_all_day?: boolean, project_id?: string, is_followed?: boolean, responsible_id?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/create/team/member` — Tool to add a team member in Nozbe Teams. Use when you need to add an existing user to a team with a specific role and status. The user must already exist in the system before they can be added to a t
  - body: { role: string, alias?: string, status: string, team_id: string, user_id: string, description?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/create/user` — Tool to create a new placeholder user in Nozbe Teams. Use when you need to add a placeholder user to the system. Note: Only placeholder users can be created via API - attempting to create non-placehol
  - body: { name: string, color: string, time_zone?: string, is_placeholder: boolean, invitation_email?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/delete/comment` — Tool to permanently delete a comment by its ID. Use when you need to remove a comment from a task. Returns the deleted comment object with all its properties.
  - body: { id: string }
- `POST https://api.mcp.ai/api/nozbe_teams/delete/project` — Tool to delete a project in Nozbe Teams by its ID. Use when you need to permanently remove a project from the workspace.
  - body: { id: string }
- `POST https://api.mcp.ai/api/nozbe_teams/delete/reminder` — Tool to delete a reminder by its unique ID. Use when you need to remove a reminder from Nozbe Teams.
  - body: { id: string }
- `POST https://api.mcp.ai/api/nozbe_teams/delete/tag/assignment` — Tool to delete a tag assignment by its ID. Use when you need to remove a tag from a task or project.
  - body: { id: string }
- `POST https://api.mcp.ai/api/nozbe_teams/delete/task` — Tool to delete a task in Nozbe Teams by its ID. Use when you need to permanently remove a task from the workspace.
  - body: { id: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/attachment` — Tool to get attachment metadata by its ID. Use when you need to retrieve details about a specific file attached to a comment.
  - body: { file_id: string, comment_id: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/comment` — Tool to retrieve a comment by its ID from Nozbe Teams. Use when you need to fetch details of a specific comment on a task.
  - body: { id: string, fields?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/project` — Tool to retrieve a project by its ID from Nozbe Teams. Use when you need to fetch details about a specific project.
  - body: { id: string, fields?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/project/access` — Tool to retrieve project access details by ID. Use when you need to check a team member's access permissions and manager status for a specific project.
  - body: { id: string, fields?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/project/section` — Tool to retrieve a project section by ID from Nozbe Teams. Use when you need to fetch details of a specific section within a project, including its name, position, and timestamps.
  - body: { id: string, fields?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/reminder` — Tool to get a reminder by ID from Nozbe Teams. Use when you need to retrieve details about a specific reminder.
  - body: { id: string, fields?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/tag` — Tool to get a tag by ID from Nozbe Teams. Use when you need to retrieve details about a specific tag.
  - body: { id: string, fields?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/tag/assignment` — Tool to retrieve a tag assignment by its ID. Use when you need to fetch details about a specific tag-task relationship in Nozbe Teams.
  - body: { id: string, fields?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/task` — Tool to retrieve a task by its ID from Nozbe Teams. Use when you need to fetch details about a specific task.
  - body: { id: string, fields?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/task/event` — Tool to get a task event by ID. Use when you need to retrieve details about a specific task event.
  - body: { id: string, fields?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/team` — Tool to retrieve a team by its ID from Nozbe Teams. Use when you need to fetch details about a specific team.
  - body: { id: string, fields?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/team/member` — Tool to retrieve a team member by ID from Nozbe Teams. Use when you need to fetch details about a specific team member.
  - body: { id: string, fields?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/get/user` — Tool to retrieve a user by their ID from Nozbe Teams. Use when you need to fetch details about a specific user.
  - body: { id: string, fields?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/list/attachments` — Tool to get all attachments related to a specific comment in Nozbe Teams. Use when you need to retrieve attachment metadata (ID, name, size, MIME type, etc.) for a comment. Returns an array of attachm
  - body: { comment_id: string }
- `POST https://api.mcp.ai/api/nozbe_teams/list/comments` — Tool to get accessible comments with optional filtering by task_id and pagination support. Use when you need to retrieve comments, optionally filtered by task, with control over pagination and field s
  - body: { limit?: integer, fields?: string, offset?: integer, sortBy?: string, task_id?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/list/group/assignments` — Tool to get accessible group assignments from Nozbe Teams. Use when you need to retrieve assignments between groups and projects/members, with optional filtering by group_id, object_id, or group_type.
  - body: { limit?: integer, fields?: string, offset?: integer, sortBy?: string, group_id?: string, object_id?: string, group_type?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/list/project/accesses` — Tool to get accessible project accesses in Nozbe Teams. Use when you need to retrieve project access records, optionally filtered by sorting or field selection. Returns a list of project access object
  - body: { limit?: integer, fields?: string, offset?: integer, sortBy?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/list/project/groups` — Tool to get accessible project groups from Nozbe Teams. Use when you need to list or search for project groups with optional filtering by name, team, or other criteria.
  - body: { name?: string, limit?: integer, fields?: string, offset?: integer, sortBy?: string, team_id?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/list/project/sections` — Tool to retrieve accessible project sections with optional filtering. Use when you need to list sections within projects, optionally filtered by project_id.
  - body: { limit?: integer, fields?: string, offset?: integer, sortBy?: string, project_id?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/list/projects` — Tool to retrieve accessible projects with optional filtering. Use when you need to list projects, optionally filtered by team_id or is_open status.
  - body: { limit?: integer, fields?: string, offset?: integer, sortBy?: string, team_id?: string, is_single_actions?: boolean }
- `POST https://api.mcp.ai/api/nozbe_teams/list/reminders` — Tool to get accessible reminders from Nozbe Teams. Use when you need to retrieve reminders, optionally filtered by task ID, all-day status, or other parameters.
  - body: { limit?: integer, fields?: string, offset?: integer, sortBy?: string, task_id?: string, is_all_day?: boolean }
- `POST https://api.mcp.ai/api/nozbe_teams/list/tag/assignments` — Tool to get accessible tag assignments with optional filtering by tag_id or task_id. Use when you need to retrieve associations between tags and tasks, optionally filtered by specific tag or task iden
  - body: { limit?: integer, fields?: string, offset?: integer, sortBy?: string, tag_id?: string, task_id?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/list/tags` — Tool to get accessible tags from Nozbe Teams. Use when you need to retrieve tags, optionally filtered by name, favorite status, or task association.
  - body: { name?: string, limit?: integer, fields?: string, offset?: integer, sortBy?: string, task_id?: string, is_favorite?: boolean }
- `POST https://api.mcp.ai/api/nozbe_teams/list/task/events` — Tool to get accessible task events from Nozbe Teams. Use when you need to retrieve task activity history or audit trail. Filter by task_id to get events for a specific task.
  - body: { limit?: integer, fields?: string, offset?: integer, sortBy?: string, task_id?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/list/tasks` — Tool to retrieve accessible tasks from Nozbe Teams. Use when you need to query tasks with optional filters like project_id or review_reason. Supports pagination and sorting of results.
  - body: { limit?: integer, fields?: string, offset?: integer, sortBy?: string, project_id?: string, review_reason?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/list/users` — Tool to retrieve accessible users from Nozbe Teams. Use when you need to query users with optional filters like name. Supports pagination and sorting of results.
  - body: { name?: string, limit?: integer, fields?: string, offset?: integer, sortBy?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/poll/new/tasks` — Tool to poll for new tasks created since the last call. Use when you need to retrieve recently created tasks in Nozbe Teams. Optionally filter by project or responsible user, and specify which fields 
  - body: { fields?: string, project_id?: string, responsible_id?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/poll/updated/tasks` — Tool to poll for tasks that have been updated since the last call. Use when you need to retrieve recently modified tasks from Nozbe Teams.
  - body: { fields?: string, project_id?: string, responsible_id?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/update/comment` — Tool to update an existing comment in Nozbe Teams. Use when you need to modify a comment's text, pin status, deletion status, or extra metadata.
  - body: { id: string, body?: string, extra?: string, is_pinned?: boolean, is_deleted?: boolean }
- `POST https://api.mcp.ai/api/nozbe_teams/update/project` — Tool to update a project in Nozbe Teams. Use when you need to modify project properties such as name, status, color, or description. All fields except the project ID are optional - only provide fields
  - body: { id: string, name?: string, color?: string, is_open?: boolean, description?: string, is_favorite?: boolean, preferences?: string, sidebar_position?: number, is_single_actions?: boolean }
- `POST https://api.mcp.ai/api/nozbe_teams/update/project/access` — Tool to update project access permissions in Nozbe Teams. Use when modifying member privileges for a specific project.
  - body: { id: string, member_id?: string, is_manager?: boolean, project_id?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/update/task` — Tool to update a task in Nozbe Teams. Use when you need to modify task properties such as name, project, responsible user, due date, or other attributes. All fields except the task ID are optional - o
  - body: { id: string, name?: string, extra?: string, due_at?: integer, is_all_day?: boolean, project_id?: string, time_spent?: integer, is_followed?: boolean, time_needed?: integer, is_abandoned?: boolean, responsible_id?: string, priority_position?: number, project_section_id?: string }
- `POST https://api.mcp.ai/api/nozbe_teams/update/team` — Tool to update a team in Nozbe Teams. Use when you need to modify team properties such as name, color, or sidebar position. All fields except the team ID are optional - only provide fields you want to
  - body: { id: string, name?: string, color?: string, sidebar_position?: integer }
- `POST https://api.mcp.ai/api/nozbe_teams/update/team/member` — Tool to update a team member in Nozbe Teams. Use when you need to modify team member properties such as role, status, alias, or description. All fields except the team member ID are optional - only pr
  - body: { id: string, role?: string, alias?: string, status?: string, description?: string, is_favorite?: boolean, sidebar_position?: number }
- `POST https://api.mcp.ai/api/nozbe_teams/update/user` — Tool to update a user in Nozbe Teams. Use when you need to modify user properties such as name, avatar color, placeholder status, or contact information. All fields except the user ID are optional - o
  - body: { id: string, name?: string, color?: string, time_zone?: string, avatar_url?: string, is_placeholder?: boolean, invitation_email?: string }

## Example prompts
- "What can I do in Nozbe Teams?"
- "Show me a summary of my Nozbe Teams account"

## More
- Page: https://mcp.ai/nozbe_teams
- Agent spec (llms.txt): https://mcp.ai/nozbe_teams/llms.txt
- Postman collection: https://mcp.ai/nozbe_teams/postman.json