Things MCP Server logo

Things MCP Server

by excelsier

This Model Context Protocol (MCP) server allows Claude Desktop to interact with your task management data in the Things app. It enables natural language task creation, smart task analysis, and seamless integration with your existing Things 3 data.

View on GitHub

Last updated: N/A

What is Things MCP Server?

The Things MCP Server is a bridge between the Claude Desktop application and the Things task management app, leveraging the Model Context Protocol to enable AI-powered task management.

How to use Things MCP Server?

Install the server using pip or manually by cloning the repository. Configure the Things authentication token and update the Claude Desktop configuration file with the server's command and arguments. Restart Claude Desktop and use natural language to interact with your Things data.

Key features of Things MCP Server

  • Natural Language Task Creation

  • Smart Task Analysis

  • GTD & Productivity Workflows

  • Seamless Integration with Things 3

  • Access to major Things lists (Inbox, Today, Upcoming, etc.)

  • Project and area management

  • Tag operations

  • Advanced search capabilities

  • Recent items tracking

  • Detailed item information including checklists

  • Support for nested data

Use cases of Things MCP Server

  • Create tasks with natural language commands

  • Analyze projects and productivity patterns using AI

  • Implement GTD and other productivity systems with Claude's help

  • Ask Claude what's on your todo list today

  • Evaluate current todos using the Eisenhower matrix

FAQ from Things MCP Server

What is an MCP server?

An MCP server allows Claude to securely access tools and data.

How do I get my Things authentication token?

Open Things app on your Mac, go to Things → Preferences (⌘,), select the General tab, make sure 'Enable Things URLs' is checked, and look for the authentication token displayed in the preferences window.

What if I get an error about a missing token?

Run python configure_token.py to set up your token.

What if I get database access errors?

Ensure Things 3 is open when using the MCP server and that 'Enable Things URLs' is enabled in Things → Preferences → General.

How do I view the MCP logs?

Run tail -n 20 -f ~/Library/Logs/Claude/mcp*.log in the Terminal.