things-cloud-mcp

Model Context Protocol (MCP) server for Things3. Gives AI agents full read/write access to your tasks through a running things-api instance.

Setup

Prerequisites

A running things-api instance with an API key configured.

Install

uvx things-cloud-mcp

Or install from source:

pip install things-cloud-mcp

Environment Variables

Agent Configuration

Claude Code

Add to your .claude/settings.json:

{
  "mcpServers": {
    "things": {
      "command": "uvx",
      "args": ["things-cloud-mcp"],
      "env": {
        "THINGS_API_URL": "http://localhost:8000",
        "THINGS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "things": {
      "command": "uvx",
      "args": ["things-cloud-mcp"],
      "env": {
        "THINGS_API_URL": "http://localhost:8000",
        "THINGS_API_KEY": "your-api-key"
      }
    }
  }
}

Codex

{
  "mcpServers": {
    "things": {
      "command": "uvx",
      "args": ["things-cloud-mcp"],
      "env": {
        "THINGS_API_URL": "http://localhost:8000",
        "THINGS_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

Read Tools

Pagination is opt-in. Every list tool exposes limit and offset arguments, but they default to unset — calling a list tool with no arguments returns the full result set in one response. Agents that need every task should leave the parameters unset; only page (increment offset by limit until the response is shorter than limit) when a result set is too large to handle in one chunk.

Write Tools

License

Apache-2.0