add_project

add_project

Create and organize projects in Things.app with details like title, notes, tags, deadlines, and initial tasks. Assign to areas and schedule start dates for better project management.

Instructions

Create a new project in Things.app. Add notes, tags, assign to areas, and pre-populate with initial to-dos.

Input Schema

Name	Required	Description
`areaId`	No	ID of the area of responsibility to assign this project to. Use this when you know the specific area ID
`areaName`	No	Name of the area of responsibility to assign this project to (e.g., "Work", "Personal", "Health", "Finance"). Areas help organize projects by life domain
`canceled`	No	Mark the project as canceled immediately upon creation (default: false). Useful for recording projects that are no longer viable
`completed`	No	Mark the project as completed immediately upon creation (default: false). Useful for logging already completed projects
`completionDate`	No	Set a specific completion date using ISO8601 datetime (YYYY-MM-DDTHH:MM:SS). Only used when completed is true
`creationDate`	No	Override the creation date with a specific ISO8601 datetime (YYYY-MM-DDTHH:MM:SS). Useful for importing historical project data
`deadline`	No	Set a deadline for project completion in ISO date format (YYYY-MM-DD). Creates deadline tracking and reminders in Things.app
`initialTodos`	No	Array of initial to-do item descriptions to create within the project (max 50 items). Each string becomes a separate task within the project
`notes`	No	Project description, objectives, scope, or additional context (max 10,000 characters). Supports markdown formatting for rich text documentation
`tags`	No	Array of tag names for categorizing and organizing the project (max 20 tags). Tags help with filtering and project management
`title`	Yes	Project title (required). Clear name describing the project goal, outcome, or deliverable
`when`	No	Schedule when to start working on this project. Use "today" to start immediately, "tomorrow" to start next day, "evening" to start later today, "anytime" for flexible timing, "someday" for future consideration, or ISO date format (YYYY-MM-DD) for specific start date

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "areaId": {
      "description": "ID of the area of responsibility to assign this project to. Use this when you know the specific area ID",
      "type": "string"
    },
    "areaName": {
      "description": "Name of the area of responsibility to assign this project to (e.g., \"Work\", \"Personal\", \"Health\", \"Finance\"). Areas help organize projects by life domain",
      "type": "string"
    },
    "canceled": {
      "default": false,
      "description": "Mark the project as canceled immediately upon creation (default: false). Useful for recording projects that are no longer viable",
      "type": "boolean"
    },
    "completed": {
      "default": false,
      "description": "Mark the project as completed immediately upon creation (default: false). Useful for logging already completed projects",
      "type": "boolean"
    },
    "completionDate": {
      "description": "Set a specific completion date using ISO8601 datetime (YYYY-MM-DDTHH:MM:SS). Only used when completed is true",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}",
      "type": "string"
    },
    "creationDate": {
      "description": "Override the creation date with a specific ISO8601 datetime (YYYY-MM-DDTHH:MM:SS). Useful for importing historical project data",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}",
      "type": "string"
    },
    "deadline": {
      "description": "Set a deadline for project completion in ISO date format (YYYY-MM-DD). Creates deadline tracking and reminders in Things.app",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "type": "string"
    },
    "initialTodos": {
      "description": "Array of initial to-do item descriptions to create within the project (max 50 items). Each string becomes a separate task within the project",
      "items": {
        "minLength": 1,
        "type": "string"
      },
      "maxItems": 50,
      "type": "array"
    },
    "notes": {
      "description": "Project description, objectives, scope, or additional context (max 10,000 characters). Supports markdown formatting for rich text documentation",
      "maxLength": 10000,
      "type": "string"
    },
    "tags": {
      "description": "Array of tag names for categorizing and organizing the project (max 20 tags). Tags help with filtering and project management",
      "items": {
        "minLength": 1,
        "type": "string"
      },
      "maxItems": 20,
      "type": "array"
    },
    "title": {
      "description": "Project title (required). Clear name describing the project goal, outcome, or deliverable",
      "minLength": 1,
      "type": "string"
    },
    "when": {
      "anyOf": [
        {
          "enum": [
            "today",
            "tomorrow",
            "evening",
            "anytime",
            "someday"
          ],
          "type": "string"
        },
        {
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "type": "string"
        }
      ],
      "description": "Schedule when to start working on this project. Use \"today\" to start immediately, \"tomorrow\" to start next day, \"evening\" to start later today, \"anytime\" for flexible timing, \"someday\" for future consideration, or ISO date format (YYYY-MM-DD) for specific start date"
    }
  },
  "required": [
    "title"
  ],
  "type": "object"
}

Things MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Things MCP Server

Related Tools

MCP directory API