Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Just Claude Things List my tasks for today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that lets Claude read and write your Things 3 tasks on macOS via AppleScript.
macOS
Things 3 installed and running
Node.js 18+
When first used, macOS will prompt you to grant Automation permissions (System Settings → Privacy & Security → Automation)
Related MCP server: Things MCP
Add to your ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"things3": {
"command": "npx",
"args": ["-y", "things3-mcp"]
}
}
}claude mcp add things3 -- npx -y things3-mcpget_todosList todos with optional filters.
{ "status": "today" }
{ "tag": "work", "status": "anytime" }
{ "search": "meeting notes" }
{ "projectId": "ABC123" }Parameter | Type | Description |
| string | Filter by list: |
| string | Filter by project ID |
| string | Filter by area ID |
| string | Filter by tag name |
| string | Search todo titles and notes |
get_todoGet a single todo by ID with full details.
{ "id": "ABC123" }get_projectsList all projects with status, area, and tags. No parameters.
get_areasList all areas. No parameters.
get_tagsList all tags. No parameters.
create_todoCreate a new todo.
{
"title": "Review PR #42",
"notes": "Check the error handling changes",
"when": "today",
"tags": ["work"],
"checklistItems": ["Read the diff", "Run tests locally", "Leave review"]
}Parameter | Type | Description |
| string | Required. Title of the todo |
| string | Notes/description |
| string |
|
| string | Deadline date ( |
| string[] | Tag names to apply |
| string | Project ID to add this todo to |
| string | Heading within the project |
| string[] | Checklist items |
create_projectCreate a new project.
{
"title": "Q2 Planning",
"notes": "Quarterly goals and milestones",
"tags": ["work"],
"when": "2025-04-01",
"deadline": "2025-06-30"
}Parameter | Type | Description |
| string | Required. Title of the project |
| string | Notes/description |
| string | Area ID to assign to |
| string[] | Tag names |
| string |
|
| string | Deadline date ( |
update_todoUpdate an existing todo by ID.
{
"id": "ABC123",
"when": "tomorrow",
"tags": ["urgent"]
}Parameter | Type | Description |
| string | Required. Todo ID |
| string | New title |
| string | New notes (appended to existing) |
| string |
|
| string | New deadline ( |
| string[] | Tags to add |
complete_todoMark a todo as complete.
{ "id": "ABC123" }delete_todoMove a todo to Trash (recoverable from Things 3 Trash).
{ "id": "ABC123" }MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/thefactremains/just-claude-things'
If you have feedback or need assistance with the MCP directory API, please join our Discord server