period
Time period (e.g., '3d', '1w', '2m', '1y')
How to use it
period is exposed by the Things3 MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the period tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Things3 MCP
pip install Things3-MCP-server==2.0.6Other tools in Things3 MCP (39)
Create a new project with tags and todos
Create a new todo with full parameter support
Filter by area UUID
Filter by deadline (YYYY-MM-DD)
Get todos from Anytime list
Get all areas
Get todos from Inbox
Get completed todos
Get all projects
Get a random sample of items from Anytime list
Get a random sample of todos from Inbox
Get a random sample of todos, optionally filtered by project
Get recently created items
Get todos from Someday list
Get items with a specific tag
Get all tags
Get todos due today
Get todos, optionally filtered by project
Get trashed todos
Get upcoming todos
(optional, default: false) - Include contained items
Maximum number of items to return
(optional) - ID of project/area to add to (takes priority over listtitle if both provided)
(optional) - Title of project/area to add to (must exactly match existing name)
(optional) - Notes for the todo (supports Markdown formatting including checkboxes like - [ ] Task)
(optional) - Filter todos by project
Advanced search with multiple filters
Search for items in Things
Simple search by title/notes
Show a specific item or list in Things
Filter by start date (YYYY-MM-DD)
Filter by status (incomplete/completed/canceled)
Filter by tag
(optional) - Tags to apply to the todo
Title of the todo
Filter by item type (to-do/project/heading)
Update an existing project
Update an existing todo
(optional) - When to schedule the todo (today, tomorrow, evening, anytime, someday, or YYYY-MM-DD)