Things 3 MCP Server

import { Server } from "@modelcontextprotocol/sdk/server/index.js"; import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"; import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js"; import { z } from "zod"; import { getTodos, createTodo } from "./things.js"; const server = new Server( { name: "things3-mcp", version: "0.1.0", }, { capabilities: { tools: {}, }, } ); server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: [ { name: "todo_list", description: "List todos from a specific Things 3 list", inputSchema: { type: "object", properties: { listName: { type: "string", enum: ["Inbox", "Today", "Anytime", "Upcoming", "Someday", "Logbook", "Trash"], description: "The name of the list to fetch todos from. Defaults to Today." } } }, }, { name: "todo_create", description: "Create a new todo in Things 3", inputSchema: { type: "object", properties: { title: { type: "string", description: "The title of the todo" }, listName: { type: "string", enum: ["Inbox", "Today", "Anytime", "Upcoming", "Someday"], description: "The list to add the todo to. Defaults to Inbox." }, notes: { type: "string", description: "Notes for the todo" } }, required: ["title"] }, } ], }; }); server.setRequestHandler(CallToolRequestSchema, async (request) => { try { const { name, arguments: args } = request.params; if (name === "todo_list") { const { listName } = z.object({ listName: z.string().optional().default("Today"), }).parse(args); const todos = await getTodos(listName); return { content: [ { type: "text", text: JSON.stringify(todos, null, 2), }, ], }; } if (name === "todo_create") { const { title, listName, notes } = z.object({ title: z.string(), listName: z.string().optional().default("Inbox"), notes: z.string().optional(), }).parse(args); const id = await createTodo(title, listName, notes); return { content: [ { type: "text", text: `Created todo with ID: ${id}`, }, ], }; } throw new Error(`Unknown tool: ${name}`); } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); return { content: [ { type: "text", text: `Error: ${errorMessage}`, }, ], isError: true, }; } }); async function main() { const transport = new StdioServerTransport(); await server.connect(transport); console.error("Things 3 MCP Server running on stdio"); } main().catch((error) => { console.error("Fatal error in main():", error); process.exit(1); });