mcp-things/smithery.yaml at source · CaseyRo/mcp-things · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
# @format

name: mcp-things
version: 2.0.0
description: "Production-ready Model Context Protocol server for Things 3, enabling AI assistants to interact with your task management system through natural language"

# Smithery configuration
registry:
    displayName: "Things 3 Enhanced MCP Server"
    shortDescription: "Production-ready Things 3 integration with intelligent caching, circuit breakers, and comprehensive error handling"
    longDescription: |
        A production-ready Model Context Protocol (MCP) server for Things 3 on macOS, enabling AI assistants
        like Claude Desktop to manage tasks, projects, and areas through natural language. Built with the
        modern FastMCP framework, it includes enterprise-grade reliability features: intelligent caching with
        TTL management, circuit breaker patterns for failure recovery, exponential backoff retry logic, dead
        letter queue for debugging, and privacy-aware structured logging. All operations are local-only for
        complete data privacy. Perfect for GTD workflows and productivity automation on macOS.

    tags:
        - task-management
        - productivity
        - things3
        - macos
        - fastmcp
        - gtd
        - reliability
        - caching
        - circuit-breaker
        - privacy-first

    category: "Task Management"

    # Requirements
    requirements:
        os: ["macos"]
        platform: ["local"]

    # Documentation
    homepage: "https://github.com/CaseyRo/mcp-things"
    repository: "https://github.com/CaseyRo/mcp-things"
    documentation: "https://github.com/CaseyRo/mcp-things#readme"

    # Installation
    installation:
        type: "pip"
        package: "mcp-things"
    # Configuration requirements
    configuration:
        required:
            - name: "THINGS_AUTH_TOKEN"
              description: "Authentication token from Things 3 Preferences → General (configure via scripts/configure_token.py)"
              type: "string"
              secret: true
        optional:
            - name: "THINGS_MCP_HOST"
              description: "Server bind address (default: 127.0.0.1, use 0.0.0.0 to expose to network)"
              type: "string"
              default: "127.0.0.1"
            - name: "THINGS_MCP_PORT"
              description: "Server port (default: 8009)"
              type: "integer"
              default: 8009
            - name: "THINGS_MCP_LOG_LEVEL"
              description: "Logging level (DEBUG, INFO, WARNING, ERROR)"
              type: "string"
              default: "INFO"

# Build configuration
build:
    type: "python"
    python_version: "3.12"

    # Entry point
    entry_point: "src.things_mcp.fast_server:run_things_mcp_server"

    # Dependencies from pyproject.toml
    dependencies:
        - "httpx>=0.28.1"
        - "mcp[cli]>=1.2.0"
        - "things-py>=0.0.15"

# Deployment settings
deployment:
    type: "local" # This runs locally, not on Smithery's servers

# Health checks
health:
    startup_timeout: 30
    readiness_probe:
        path: "/health"
        timeout: 5

# Features/Tools provided by this MCP (19 total)
tools:
    # List Views
    - name: "get-inbox"
      description: "Retrieve items in Inbox"
    - name: "get-today"
      description: "Get tasks due today"
    - name: "get-upcoming"
      description: "View upcoming scheduled tasks"
    - name: "get-anytime"
      description: "List Anytime tasks"
    - name: "get-someday"
      description: "List Someday/Maybe items"
    - name: "get-logbook"
      description: "Access completed items (configurable period)"
    - name: "get-trash"
      description: "View deleted items"

    # Task Operations
    - name: "get-todos"
      description: "List all todos (optionally filtered by project)"
    - name: "add-todo"
      description: "Create new tasks with full metadata (title, notes, dates, tags, checklists)"
    - name: "update-todo"
      description: "Modify existing tasks"

    # Project & Area Management
    - name: "get-projects"
      description: "List all projects"
    - name: "get-areas"
      description: "List all areas"
    - name: "add-project"
      description: "Create new projects with initial todos"
    - name: "update-project"
      description: "Modify existing projects"

    # Tag Operations
    - name: "get-tags"
      description: "List all tags"
    - name: "get-tagged-items"
      description: "Filter items by tag"

    # Search & Discovery
    - name: "search-todos"
      description: "Search by title or notes"
    - name: "search-advanced"
      description: "Multi-criteria filtering (status, dates, tags, areas)"
    - name: "search-items"
      description: "Open search in Things app"
    - name: "show-item"
      description: "Display specific item or list in Things"

    # Diagnostics
    - name: "get-recent"
      description: "Recently created items"
    - name: "get-cache-stats"
      description: "Cache performance metrics"