---
title: "Create a new task in AI Note. Supports full task creation with dates, times, location, notes, and notifications."
method: POST
path: "/api/mcp/tools/create_task"
tags: ["tasks"]
---

# Create a new task in AI Note. Supports full task creation with dates, times, location, notes, and notifications.

`POST /api/mcp/tools/create_task`

## Request

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

Create a new task in AI Note. Supports full task creation with dates, times, location, notes, and notifications.

## Request body

- object
  - `content` string, required: Task content (required)
  - `is_important` boolean: Mark task as important (default: false)
  - `due_date` string: Due date in ISO format (e.g., '2026-01-28' or '2026-01-28T15:00:00+09:00')
  - `due_time` string: Due time in HH:MM format (e.g., '15:00'). If not provided, task is treated as all-day.
  - `start_date` string: Start date for date range tasks in ISO format (e.g., for multi-day events)
  - `is_all_day` boolean: Mark as all-day event — suppresses time-of-day rendering.
  - `category_id` string: Category ID (UUID) to organize the task
  - `notes` string: Additional notes or details for the task
  - `location` string: Location where the task takes place
  - `location_lat` number: GPS latitude. Pair with location_lng.
  - `location_lng` number: GPS longitude. Pair with location_lat.
  - `travel_time` number: Minutes of travel time to allow before due_date.
  - `has_notification` boolean: Enable reminder notifications (default: false)
  - `reminder_timing` integer: Minutes before due time to send reminder (e.g., 10 for 10 minutes before). Default: 30. Only used when has_notification is true.
  - `reminder_timings` integer[]: Multiple reminder offsets in minutes before due time (e.g., [10, 60] fires 10 min and 1 hour before). Overrides reminder_timing if provided.
  - `repeat_rule` string: Recurrence rule (e.g., 'daily', 'weekly', 'monthly', 'yearly', or RRULE format)

## 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)