things-mcp 0.2.1

Local-first MCP server bridging Claude to Things 3 on macOS — 29 tools for read, search, write, and tag CRUD.
Documentation 
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

//! `Operation` — typed write operations, each capable of rendering itself
//! as a single Things JSON URL operation element.

pub mod add_project;
pub mod add_todo;
pub mod bulk;
pub mod move_todo;
pub mod status_change;
pub mod update_project;
pub mod update_todo;

pub use add_project::AddProjectSpec;
pub use add_todo::AddTodoSpec;
pub use bulk::BulkRawSpec;
pub use move_todo::MoveTodoSpec;
pub use update_project::UpdateProjectSpec;
pub use update_todo::UpdateTodoSpec;

use serde::{Deserialize, Serialize};
use serde_json::Value;

#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum Operation {
    AddTodo(AddTodoSpec),
    AddProject(AddProjectSpec),
    UpdateTodo(UpdateTodoSpec),
    UpdateProject(UpdateProjectSpec),
    CompleteTodo { id: String },
    CancelTodo { id: String },
    MoveTodo(MoveTodoSpec),
    BulkRaw(BulkRawSpec),
}

impl Operation {
    pub fn action_name(&self) -> &'static str {
        match self {
            Operation::AddTodo(_) => "add_todo",
            Operation::AddProject(_) => "add_project",
            Operation::UpdateTodo(_) => "update_todo",
            Operation::UpdateProject(_) => "update_project",
            Operation::CompleteTodo { .. } => "complete_todo",
            Operation::CancelTodo { .. } => "cancel_todo",
            Operation::MoveTodo(_) => "move_todo",
            Operation::BulkRaw(_) => "bulk_json",
        }
    }

    pub fn requires_auth_token(&self) -> bool {
        match self {
            Operation::AddTodo(_) => false,
            Operation::AddProject(_) => false,
            Operation::UpdateTodo(_) => true,
            Operation::UpdateProject(_) => true,
            Operation::CompleteTodo { .. } => true,
            Operation::CancelTodo { .. } => true,
            Operation::MoveTodo(_) => true,
            // Conservative: bulk may carry update operations, and the chassis
            // can't introspect the payload. Demand the token if present;
            // the Writer's auth gate will only fire if no token is configured.
            Operation::BulkRaw(_) => true,
        }
    }

    pub fn render_json(&self) -> Value {
        match self {
            Operation::AddTodo(spec) => add_todo::render_add_todo(spec),
            Operation::AddProject(spec) => add_project::render_add_project(spec),
            Operation::UpdateTodo(spec) => update_todo::render_update_todo(spec),
            Operation::UpdateProject(spec) => update_project::render_update_project(spec),
            Operation::CompleteTodo { id } => status_change::render_complete_todo(id),
            Operation::CancelTodo { id } => status_change::render_cancel_todo(id),
            Operation::MoveTodo(spec) => move_todo::render_move_todo(spec),
            Operation::BulkRaw(spec) => bulk::render_bulk_first(spec),
        }
    }

    /// Returns the full batch as multiple JSON elements. For non-bulk variants,
    /// this is a single-element vec wrapping `render_json()`. For `BulkRaw`,
    /// the entire `operations` vec is returned. `build_url` uses this to
    /// compose the URL's payload array.
    pub fn render_batch(&self) -> Vec<Value> {
        match self {
            Operation::BulkRaw(spec) => spec.operations.clone(),
            _ => vec![self.render_json()],
        }
    }
}