# MeisterTask

> Work with your MeisterTask boards: list, create, update, complete, move and assign tasks and subtasks, manage projects, sections and labels, and read and add comments.

App · 26 actions. Web page: https://docs.lodol.com/docs/integrations/meistertask

## Actions

### Add comment

Comment on a task as the connected person. Markdown works.

**Inputs**

- Task ID (`task_id`, text, required): The task's id, from 'List tasks' or an earlier step.
- Comment (`text`, text, required): What to say.

**Outputs**

- `comment` (object): The comment

**Example output**

```json
{
  "comment": {
    "created_at": "2026-04-02T03:14:15.926535Z",
    "id": 2,
    "person_id": 8,
    "task_id": 15,
    "text": "Looks awesome!",
    "text_html": "<p>Looks awesome!</p>\n",
    "updated_at": "2026-04-02T03:14:15.926535Z"
  }
}
```

### Add label to task

Put a label on a task. The label must belong to the task's project.

**Inputs**

- Project (`project_id`, text): The project, to load its choices below. Not needed when you give the id from an earlier step.
- Task ID (`task_id`, text, required): The task's id, from 'List tasks' or an earlier step.
- Label (`label_id`, text, required): The label (tag). Pick a project first to load its labels.

**Outputs**

- `task_id` (number): The task
- `task_label` (object): The link between task and label

**Example output**

```json
{
  "task_id": 15,
  "task_label": {
    "id": 364,
    "label_id": 25,
    "task_id": 15
  }
}
```

### Create label

Add a label to a project. Names are unique within a project, ignoring case.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Name (`name`, text, required): The label's name.
- Color (`color`, text): The label's color. Defaults to red. One of: `d93651` (Red (default)), `ff9f1a` (Orange), `ffd500` (Yellow), `8acc47` (Grass green), `47cc8a` (Moss green), `30bfbf` (Turquoise), `00aaff` (Blue), `8f7ee6` (Purple), `98aab3` (Grey).

**Outputs**

- `label` (object): The label

**Example output**

```json
{
  "label": {
    "color": "47cc8a",
    "id": 25,
    "name": "Feature",
    "project_id": 123
  }
}
```

### Create project

Create a project with a name and optional notes.

**Inputs**

- Name (`name`, text, required): The project's name.
- Description (`notes`, text): What the project is for.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "project": {
    "created_at": "2026-01-13T09:29:36.360375Z",
    "id": 123,
    "name": "Getting Started",
    "notes": "A demo project",
    "status": 1,
    "token": "s3i5reaF",
    "updated_at": "2026-01-16T10:10:21.460697Z"
  }
}
```

### Create section

Add a section (column) to a project.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Name (`name`, text, required): The section's name.

**Outputs**

- `section` (object): The section

**Example output**

```json
{
  "section": {
    "color": "30bfbf",
    "created_at": "2026-01-13T09:29:36.722740Z",
    "description": "Work in progress",
    "id": 73,
    "indicator": 24,
    "name": "Open",
    "project_id": 123,
    "sequence": 1,
    "status": 1,
    "updated_at": "2026-01-13T09:29:36.722616Z"
  }
}
```

### Create subtask

Create a task under another task, in the same section.

**Inputs**

- Parent task ID (`task_id`, text, required): The task to add the subtask under, from 'List tasks' or an earlier step.
- Name (`name`, text, required): The subtask's title.
- Description (`notes`, text): The subtask's description. Markdown works.
- Assignee (`assigned_to_id`, text): The person the task is assigned to.
- Due (`due`, date and time): When the task is due.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "task": {
    "assigned_to_id": 8,
    "created_at": "2026-02-06T17:01:33.635649Z",
    "due": "2026-11-20T17:00:00Z",
    "id": 16,
    "name": "Draft the email",
    "notes": "Before Friday",
    "project_id": 123,
    "section_id": 73,
    "section_name": "Open",
    "sequence": 100,
    "status": 1,
    "status_updated_at": "2026-05-09T14:49:18.303930Z",
    "token": "gvuUs17f",
    "tracked_time": 0,
    "updated_at": "2026-05-09T14:49:18.304227Z"
  }
}
```

### Create task

Create a task in a section, or in a project's first section, with an optional description, assignee, due date and labels.

**Inputs**

- Project (`project_id`, text): The project to add the task to. With no section, the task goes in the project's first section.
- Section (`section_id`, text): The section (column). Pick a project first to load its sections.
- Name (`name`, text, required): The task's title.
- Description (`notes`, text): The task's description. Markdown works.
- Assignee (`assigned_to_id`, text): The person the task is assigned to.
- Due (`due`, date and time): When the task is due.
- Labels (`label_ids`, list): Labels to put on the task. Pick a project first to load its labels.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "task": {
    "assigned_to_id": 8,
    "created_at": "2026-02-06T17:01:33.635649Z",
    "due": "2026-11-20T17:00:00Z",
    "id": 15,
    "name": "Send the invoice",
    "notes": "Before Friday",
    "project_id": 123,
    "section_id": 73,
    "section_name": "Open",
    "sequence": 100,
    "status": 1,
    "status_updated_at": "2026-05-09T14:49:18.303930Z",
    "token": "gvuUs17f",
    "tracked_time": 0,
    "updated_at": "2026-05-09T14:49:18.304227Z"
  }
}
```

### Delete comment

Delete a comment. MeisterTask lets people delete only their own.

**Inputs**

- Comment ID (`comment_id`, text, required): The comment's id, from 'List comments' or 'Add comment'.

**Outputs**

- `comment_id` (number): The comment deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "comment_id": 2,
  "deleted": true
}
```

### Delete label

Delete a label from its project, which takes it off every task that has it.

**Inputs**

- Project (`project_id`, text): The project, to load its choices below. Not needed when you give the id from an earlier step.
- Label (`label_id`, text, required): The label (tag). Pick a project first to load its labels.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `label_id` (number): The label deleted

**Example output**

```json
{
  "deleted": true,
  "label_id": 25
}
```

### Get current user

Get the MeisterTask person the connection acts as: name, email and avatar.

**Inputs**: None.

**Outputs**

- `person` (object): The person

**Example output**

```json
{
  "person": {
    "avatar": "https://www.example.com/avatars/jane.jpg",
    "avatar_thumb": "https://www.example.com/avatars/jane-thumb.jpg",
    "created_at": "2026-01-13T09:29:36.360375Z",
    "email": "jane@example.com",
    "firstname": "Jane",
    "id": 8,
    "lastname": "Demo",
    "updated_at": "2026-01-16T10:10:21.460697Z"
  }
}
```

### Get project

Get one project with its name, notes and status.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, or give its id from an earlier step.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "project": {
    "created_at": "2026-01-13T09:29:36.360375Z",
    "id": 123,
    "name": "Getting Started",
    "notes": "A demo project",
    "status": 1,
    "token": "s3i5reaF",
    "updated_at": "2026-01-16T10:10:21.460697Z"
  }
}
```

### Get task

Get one task with its section, assignee, due date and status.

**Inputs**

- Task ID (`task_id`, text, required): The task's id, from 'List tasks' or an earlier step.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "task": {
    "assigned_to_id": 8,
    "created_at": "2026-02-06T17:01:33.635649Z",
    "due": "2026-11-20T17:00:00Z",
    "id": 15,
    "name": "Send the invoice",
    "notes": "Before Friday",
    "project_id": 123,
    "section_id": 73,
    "section_name": "Open",
    "sequence": 100,
    "status": 1,
    "status_updated_at": "2026-05-09T14:49:18.303930Z",
    "token": "gvuUs17f",
    "tracked_time": 0,
    "updated_at": "2026-05-09T14:49:18.304227Z"
  }
}
```

### List comments

List the comments on a task, with who wrote them and when.

**Inputs**

- Task ID (`task_id`, text, required): The task's id, from 'List tasks' or an earlier step.
- Page size (`limit`, number): How many to return, 1 to 500. MeisterTask's default is 50. From 1 to 500.
- Page (`page`, number): Which page to return, starting at 1. Use 'Next page' from the last run. At least 1.

**Outputs**

- `comments` (list): The comments
- `count` (number): How many on this page
- `has_more` (true/false): True when another page follows this one
- `next_page` (number): Pass as 'page' for the next page; 0 on the last one
- `page` (number): The page number returned

**Example output**

```json
{
  "comments": [
    {
      "created_at": "2026-04-02T03:14:15.926535Z",
      "id": 2,
      "person_id": 8,
      "task_id": 15,
      "text": "Looks awesome!",
      "text_html": "<p>Looks awesome!</p>\n",
      "updated_at": "2026-04-02T03:14:15.926535Z"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1
}
```

### List labels

List a project's labels (called tags in MeisterTask) with their colors.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, or give its id from an earlier step.

**Outputs**

- `count` (number): How many
- `labels` (list): The labels

**Example output**

```json
{
  "count": 1,
  "labels": [
    {
      "color": "47cc8a",
      "id": 25,
      "name": "Feature",
      "project_id": 123
    }
  ]
}
```

### List people

List the people you share projects with, or the people who have access to one project. Their ids are what 'Assignee' takes.

**Inputs**

- Project (`project_id`, text): Only people with access to this project. Leave empty for everyone.

**Outputs**

- `count` (number): How many
- `persons` (list): The people

**Example output**

```json
{
  "count": 1,
  "persons": [
    {
      "avatar": "https://www.example.com/avatars/jane.jpg",
      "avatar_thumb": "https://www.example.com/avatars/jane-thumb.jpg",
      "created_at": "2026-01-13T09:29:36.360375Z",
      "email": "jane@example.com",
      "firstname": "Jane",
      "id": 8,
      "lastname": "Demo",
      "updated_at": "2026-01-16T10:10:21.460697Z"
    }
  ]
}
```

### List project tasks

List the tasks of one project, or of one of its sections. Gets one page; to see more, run it again with the next page.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Section (`section_id`, text): Only tasks in this section. Pick a project first to load its sections.
- Status (`status`, text): Which tasks to include. Defaults to MeisterTask's own default. One of: `open`, `completed`, `completed_archived` (Completed and archived), `trashed`.
- Only my tasks (`assigned_to_me`, true/false): Only tasks assigned to you. Default: `false`.
- Order (`sort`, text): How to order the tasks. Defaults to oldest first. One of: `id` (Oldest first (default)), `-id` (Newest first), `-updated_at` (Recently changed first), `due` (Due soonest first).
- Page size (`limit`, number): How many to return, 1 to 500. MeisterTask's default is 50. From 1 to 500.
- Page (`page`, number): Which page to return, starting at 1. Use 'Next page' from the last run. At least 1.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True when another page follows this one
- `next_page` (number): Pass as 'page' for the next page; 0 on the last one
- `page` (number): The page number returned
- `tasks` (list): The tasks

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1,
  "tasks": [
    {
      "assigned_to_id": 8,
      "created_at": "2026-02-06T17:01:33.635649Z",
      "due": "2026-11-20T17:00:00Z",
      "id": 15,
      "name": "Send the invoice",
      "notes": "Before Friday",
      "project_id": 123,
      "section_id": 73,
      "section_name": "Open",
      "sequence": 100,
      "status": 1,
      "status_updated_at": "2026-05-09T14:49:18.303930Z",
      "token": "gvuUs17f",
      "tracked_time": 0,
      "updated_at": "2026-05-09T14:49:18.304227Z"
    }
  ]
}
```

### List projects

List your projects, active ones unless you choose archived or all. Gets one page; to see more, run it again with the next page.

**Inputs**

- Status (`status`, text): Which projects to include. Defaults to active. One of: `active` (Active (default)), `archived`, `all` (Active and archived).
- Page size (`limit`, number): How many to return, 1 to 500. MeisterTask's default is 50. From 1 to 500.
- Page (`page`, number): Which page to return, starting at 1. Use 'Next page' from the last run. At least 1.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True when another page follows this one
- `next_page` (number): Pass as 'page' for the next page; 0 on the last one
- `page` (number): The page number returned
- `projects` (list): The projects

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1,
  "projects": [
    {
      "created_at": "2026-01-13T09:29:36.360375Z",
      "id": 123,
      "name": "Getting Started",
      "notes": "A demo project",
      "status": 1,
      "token": "s3i5reaF",
      "updated_at": "2026-01-16T10:10:21.460697Z"
    }
  ]
}
```

### List sections

List a project's sections (the columns tasks sit in), in board order.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Status (`status`, text): Which sections to include. Defaults to active. One of: `active` (Active (default)), `trashed`, `all` (Active and trashed).
- Page size (`limit`, number): How many to return, 1 to 500. MeisterTask's default is 50. From 1 to 500.
- Page (`page`, number): Which page to return, starting at 1. Use 'Next page' from the last run. At least 1.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True when another page follows this one
- `next_page` (number): Pass as 'page' for the next page; 0 on the last one
- `page` (number): The page number returned
- `sections` (list): The sections

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1,
  "sections": [
    {
      "color": "30bfbf",
      "created_at": "2026-01-13T09:29:36.722740Z",
      "description": "Work in progress",
      "id": 73,
      "indicator": 24,
      "name": "Open",
      "project_id": 123,
      "sequence": 1,
      "status": 1,
      "updated_at": "2026-01-13T09:29:36.722616Z"
    }
  ]
}
```

### List subtasks

List the tasks under a task.

**Inputs**

- Task ID (`task_id`, text, required): The task's id, from 'List tasks' or an earlier step.
- Page size (`limit`, number): How many to return, 1 to 500. MeisterTask's default is 50. From 1 to 500.
- Page (`page`, number): Which page to return, starting at 1. Use 'Next page' from the last run. At least 1.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True when another page follows this one
- `next_page` (number): Pass as 'page' for the next page; 0 on the last one
- `page` (number): The page number returned
- `tasks` (list): The subtasks

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1,
  "tasks": [
    {
      "assigned_to_id": 8,
      "created_at": "2026-02-06T17:01:33.635649Z",
      "due": "2026-11-20T17:00:00Z",
      "id": 15,
      "name": "Send the invoice",
      "notes": "Before Friday",
      "project_id": 123,
      "section_id": 73,
      "section_name": "Open",
      "sequence": 100,
      "status": 1,
      "status_updated_at": "2026-05-09T14:49:18.303930Z",
      "token": "gvuUs17f",
      "tracked_time": 0,
      "updated_at": "2026-05-09T14:49:18.304227Z"
    }
  ]
}
```

### List task labels

List the labels on a task.

**Inputs**

- Task ID (`task_id`, text, required): The task's id, from 'List tasks' or an earlier step.

**Outputs**

- `count` (number): How many
- `labels` (list): The labels on the task

**Example output**

```json
{
  "count": 1,
  "labels": [
    {
      "color": "47cc8a",
      "id": 25,
      "name": "Feature",
      "project_id": 123
    }
  ]
}
```

### List tasks

List tasks from every project you can see, filtered by status or to your own. Gets one page; to see more, run it again with the next page.

**Inputs**

- Status (`status`, text): Which tasks to include. Defaults to MeisterTask's own default. One of: `open`, `completed`, `completed_archived` (Completed and archived), `trashed`.
- Only my tasks (`assigned_to_me`, true/false): Only tasks assigned to you. Default: `false`.
- Order (`sort`, text): How to order the tasks. Defaults to oldest first. One of: `id` (Oldest first (default)), `-id` (Newest first), `-updated_at` (Recently changed first), `due` (Due soonest first).
- Page size (`limit`, number): How many to return, 1 to 500. MeisterTask's default is 50. From 1 to 500.
- Page (`page`, number): Which page to return, starting at 1. Use 'Next page' from the last run. At least 1.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True when another page follows this one
- `next_page` (number): Pass as 'page' for the next page; 0 on the last one
- `page` (number): The page number returned
- `tasks` (list): The tasks

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1,
  "tasks": [
    {
      "assigned_to_id": 8,
      "created_at": "2026-02-06T17:01:33.635649Z",
      "due": "2026-11-20T17:00:00Z",
      "id": 15,
      "name": "Send the invoice",
      "notes": "Before Friday",
      "project_id": 123,
      "section_id": 73,
      "section_name": "Open",
      "sequence": 100,
      "status": 1,
      "status_updated_at": "2026-05-09T14:49:18.303930Z",
      "token": "gvuUs17f",
      "tracked_time": 0,
      "updated_at": "2026-05-09T14:49:18.304227Z"
    }
  ]
}
```

### Remove label from task

Take a label off a task. Nothing happens if the task does not have it.

**Inputs**

- Project (`project_id`, text): The project, to load its choices below. Not needed when you give the id from an earlier step.
- Task ID (`task_id`, text, required): The task's id, from 'List tasks' or an earlier step.
- Label (`label_id`, text, required): The label (tag). Pick a project first to load its labels.

**Outputs**

- `label_id` (number): The label
- `removed` (true/false): True if the label was on the task and is now off it
- `task_id` (number): The task

**Example output**

```json
{
  "label_id": 25,
  "removed": true,
  "task_id": 15
}
```

### Update label

Rename a label or change its color. Empty fields stay as they are.

**Inputs**

- Project (`project_id`, text): The project, to load its choices below. Not needed when you give the id from an earlier step.
- Label (`label_id`, text, required): The label (tag). Pick a project first to load its labels.
- Name (`name`, text): A new name. Leave empty to keep it.
- Color (`color`, text): A new color. Leave empty to keep it. One of: `d93651` (Red (default)), `ff9f1a` (Orange), `ffd500` (Yellow), `8acc47` (Grass green), `47cc8a` (Moss green), `30bfbf` (Turquoise), `00aaff` (Blue), `8f7ee6` (Purple), `98aab3` (Grey).

**Outputs**

- `label` (object): The label

**Example output**

```json
{
  "label": {
    "color": "47cc8a",
    "id": 25,
    "name": "Feature",
    "project_id": 123
  }
}
```

### Update project

Rename a project, change its description, or archive, trash or restore it. Empty fields stay as they are.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Description (`notes`, text): A new description. Leave empty to keep it.
- Status (`status`, text): Archive, trash or restore (Active) the project. Trashed projects can be restored in MeisterTask. Leave empty to keep it. One of: `active`, `archived`, `trashed`.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "project": {
    "created_at": "2026-01-13T09:29:36.360375Z",
    "id": 123,
    "name": "Getting Started",
    "notes": "A demo project",
    "status": 1,
    "token": "s3i5reaF",
    "updated_at": "2026-01-16T10:10:21.460697Z"
  }
}
```

### Update section

Rename a section, or trash or restore it. Empty fields stay as they are.

**Inputs**

- Project (`project_id`, text): The project, to load its choices below. Not needed when you give the id from an earlier step.
- Section (`section_id`, text, required): The section (column). Pick a project first to load its sections.
- Name (`name`, text): A new name. Leave empty to keep it.
- Status (`status`, text): Trash or restore (Active) the section. Leave empty to keep it. One of: `active`, `trashed`.

**Outputs**

- `section` (object): The section

**Example output**

```json
{
  "section": {
    "color": "30bfbf",
    "created_at": "2026-01-13T09:29:36.722740Z",
    "description": "Work in progress",
    "id": 73,
    "indicator": 24,
    "name": "Open",
    "project_id": 123,
    "sequence": 1,
    "status": 1,
    "updated_at": "2026-01-13T09:29:36.722616Z"
  }
}
```

### Update task

Change a task: rename it, reassign it, set a due date, move it to another section, or complete, reopen, archive or trash it. Empty fields stay as they are.

**Inputs**

- Project (`project_id`, text): The project, to load its choices below. Not needed when you give the id from an earlier step.
- Task ID (`task_id`, text, required): The task's id, from 'List tasks' or an earlier step.
- Name (`name`, text): A new title. Leave empty to keep it.
- Description (`notes`, text): A new description. Leave empty to keep it.
- Assignee (`assigned_to_id`, text): Assign the task to this person. Leave empty to keep it.
- Due (`due`, date and time): A new due date and time. Leave empty to keep it.
- Move to section (`section_id`, text): Move the task to this section. Leave empty to keep it where it is.
- Status (`status`, text): Complete, reopen, archive or trash the task. Trashed tasks can be restored in MeisterTask. Leave empty to keep it. One of: `open`, `completed`, `completed_archived` (Completed and archived), `trashed`.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "task": {
    "assigned_to_id": 8,
    "created_at": "2026-02-06T17:01:33.635649Z",
    "due": "2026-11-20T17:00:00Z",
    "id": 15,
    "name": "Send the invoice",
    "notes": "Before Friday",
    "project_id": 123,
    "section_id": 73,
    "section_name": "Open",
    "sequence": 100,
    "status": 1,
    "status_updated_at": "2026-05-09T14:49:18.303930Z",
    "token": "gvuUs17f",
    "tracked_time": 0,
    "updated_at": "2026-05-09T14:49:18.304227Z"
  }
}
```
