---
title: "List all tasks from AI Note with advanced filtering, date ranges, location search, and sorting"
method: POST
path: "/api/mcp/tools/list_tasks"
tags: ["tasks"]
---

# List all tasks from AI Note with advanced filtering, date ranges, location search, and sorting

`POST /api/mcp/tools/list_tasks`

## Request

- Base URL: `https://api.ainote.dev`
- URL: `https://api.ainote.dev/api/mcp/tools/list_tasks`
- Auth: API key in header `Authorization`

List all tasks from AI Note with advanced filtering, date ranges, location search, and sorting

## Request body

- object
  - `status` 'pending' | 'completed': Filter by task status
  - `is_important` boolean: Filter by important tasks only
  - `limit` number: Maximum number of tasks to return (default: 25, max: 500)
  - `offset` number: Number of tasks to skip for pagination (default: 0). Use with limit to fetch additional pages.
  - `search` string: Search keyword in task content and notes (case-insensitive partial match)
  - `location` string: Filter by location (partial match, e.g., '여의도', '서울')
  - `category_id` string: Filter by category UUID
  - `due_date_start` string: Filter tasks with due_date >= this date (ISO 8601 format)
  - `due_date_end` string: Filter tasks with due_date <= this date (ISO 8601 format)
  - `completed_date_start` string: Filter tasks completed >= this date (ISO 8601 format)
  - `completed_date_end` string: Filter tasks completed <= this date (ISO 8601 format)
  - `created_date_start` string: Filter tasks created >= this date (ISO 8601 format)
  - `created_date_end` string: Filter tasks created <= this date (ISO 8601 format)
  - `overdue` boolean: Filter overdue incomplete tasks (due_date < today)
  - `due_today` boolean: Filter tasks due today
  - `has_notification` boolean: Filter by notification enabled status
  - `sort_by` 'due_date' | 'created_at' | 'completed_at' | 'updated_at' | 'is_important': Sort field (default: created_at)
  - `sort_order` 'asc' | 'desc': Sort order (default: desc)

## Response `200`

Tool executed successfully

- ToolSuccessResponse: Successful tool invocation. `content` mirrors the MCP `tools/call` result shape: an array of content blocks (text and optionally a structured resource payload).
  - `content` object[]
    - `type` 'text' | 'resource'
    - `text` string

## Other responses

- `400`: Invalid arguments or business-rule violation
- `401`: Missing or invalid McpKey

---

[API](https://skmtc.dev/ainote/apis/ainote-mcp-openapi-mirror.md) · [All operations](https://skmtc.dev/ainote/apis/ainote-mcp-openapi-mirror/llms.txt) · [OpenAPI document](https://skmtc.dev/ainote/apis/ainote-mcp-openapi-mirror/revisions/f6c91d85e027?raw)