Things MCP Server
MCP 서버 관련 사항
이 모델 컨텍스트 프로토콜(MCP) 서버를 사용하면 Claude Desktop을 사용하여 Things 앱 의 작업 관리 데이터와 상호 작용할 수 있습니다. Claude에게 작업 생성, 프로젝트 분석, 우선순위 관리 등의 작업을 요청할 수 있습니다.
이 서버는 Things.py 라이브러리와 Things URL Scheme을 활용합니다.
특징
모든 주요 일정 목록(받은 편지함, 오늘, 예정된 일정 등)에 액세스할 수 있습니다.
프로젝트 및 지역 관리
태그 작업
고급 검색 기능
최근 항목 추적
체크리스트를 포함한 자세한 품목 정보
중첩된 데이터 지원(영역 내 프로젝트, 프로젝트 내 할 일)
Related MCP server: Things MCP
설치(Claude Desktop용)
필수 조건
파이썬 3.12+
클로드 데스크탑
Things 3("Things URL 사용"은 설정 -> 일반에서 켜야 함)
아직 uv를 설치하지 않았다면 설치하세요:
지엑스피1
그런 다음 터미널을 다시 시작하세요.
이 저장소를 복제하세요:
git clone https://github.com/hald/things-mcp필요한 Python 패키지를 설치하세요.
cd things-mcp
uv venv
uv pip install -r pyproject.tomlClaude Desktop 구성 파일을 편집합니다.
code ~/Library/Application\ Support/Claude/claude_desktop_config.json구성 파일의 mcpServers 키에 Things 서버를 추가합니다(이러한 파일을 설치한 폴더의 경로를 업데이트해야 합니다).
{
"mcpServers": {
"things": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
"run",
"things_server.py"
]
}
}
}Claude Desktop 앱을 다시 시작합니다.
Claude Desktop을 사용한 샘플 사용
"오늘 내 할 일 목록에는 무엇이 있나요?"
"다음 주 해변 휴가를 위해 짐을 싸야 할 일 목록을 만들고, 짐 싸기 체크리스트를 포함하세요."
"아이젠하워 매트릭스를 사용하여 현재 할 일을 평가하세요."
"Things를 사용하여 GTD 스타일의 주간 검토를 도와주세요."
팁
Claude에서 Things을 사용하는 방법과 영역, 프로젝트, 태그 등을 구성하는 방법을 설명하는 사용자 지정 지침이 있는 프로젝트를 만듭니다. Claude가 새 작업을 만들 때 포함할 정보를 알려줍니다(예: 작업 설명에 관련 세부 정보를 포함하도록 요청하는 것이 도움이 될 수 있음).
Claude가 캘린더에 접근할 수 있도록 다른 MCP 서버를 추가해 보세요. 이렇게 하면 Claude에게 특정 작업을 위해 캘린더에서 시간을 차단하거나, 예정된 캘린더 이벤트(예: 회의 준비)에서 할 일을 만드는 등의 작업을 할 수 있습니다.
사용 가능한 도구
목록 보기
get-inbox- Inbox에서 할 일 가져오기get-today- 오늘 마감일인 할 일 가져오기get-upcoming- 예정된 할 일 가져오기get-anytime- Anytime 목록에서 할 일 가져오기get-someday- Someday 목록에서 할 일 가져오기get-logbook- 완료된 할 일 가져오기get-trash- 휴지통에 버린 할 일 목록 가져오기
기본 작업
get-todos- 프로젝트별로 필터링하여 할 일 가져오기get-projects- 모든 프로젝트 가져오기get-areas- 모든 지역 가져오기
태그 작업
get-tags- 모든 태그 가져오기get-tagged-items- 특정 태그가 있는 항목 가져오기
검색 작업
search-todos- 제목/메모로 간단 검색search-advanced- 여러 필터를 사용한 고급 검색
시간 기반 작업
get-recent- 최근에 생성된 항목 가져오기
도구 매개변수
할 일 목록
project_uuid(선택 사항) - 프로젝트별로 할 일 필터링include_items(선택 사항, 기본값: true) - 체크리스트 항목 포함
get-projects / get-areas / get-tags
include_items(선택 사항, 기본값: false) - 포함된 항목 포함
검색-고급
status- 상태별 필터링(미완료/완료/취소)start_date- 시작일(YYYY-MM-DD)로 필터링deadline- 마감일(YYYY-MM-DD)로 필터링tag- 태그로 필터링area- 지역 UUID로 필터링type- 항목 유형(할 일/프로젝트/제목)으로 필터링
최근 게시물 가져오기
period- 기간(예: '3일', '1주', '2개월', '1년')
문제 해결
서버에는 다음에 대한 오류 처리가 포함되어 있습니다.
잘못된 UUID
필수 매개변수가 없습니다
사물 데이터베이스 접근 오류
데이터 형식 오류
모든 오류는 기록되고 설명 메시지와 함께 반환됩니다. Claude Desktop에서 MCP 로그를 확인하려면 터미널에서 다음 명령어를 실행하세요.
# Follow logs in real-time
tail -n 20 -f ~/Library/Logs/Claude/mcp*.logAvailable Tools
22 toolsadd_projectB
Create a new project in Things
Args: title: Title of the project notes: Notes for the project when: When to schedule the project deadline: Deadline for the project tags: Tags to apply to the project area_id: ID of area to add to area_title: Title of area to add to todos: Initial todos to create in the project
Inputs: title (required), area_id, area_title, deadline, +4 more. Returns: result
add_todoB
Create a new todo in Things
Args: title: Title of the todo notes: Notes for the todo when: When to schedule the todo (today, tomorrow, evening, anytime, someday, or YYYY-MM-DD) deadline: Deadline for the todo (YYYY-MM-DD) tags: Tags to apply to the todo checklist_items: Checklist items to add list_id: ID of project/area to add to list_title: Title of project/area to add to heading: Heading title to add under heading_id: Heading ID to add under (takes precedence over heading)
Inputs: title (required), checklist_items, deadline, heading, +6 more. Returns: result
get_anytimeC
Get todos from Anytime list
Inputs: no named parameters. Returns: result
get_areasC
Get all areas from Things
Args: include_items: Include projects and tasks within areas
Inputs: include_items. Returns: result
get_headingsC
Get headings from Things
Args: project_uuid: Optional UUID of a specific project to get headings from
Inputs: project_uuid. Returns: result
get_inboxC
Get todos from Inbox
Inputs: no named parameters. Returns: result
get_logbookA
Get completed todos from Logbook, defaults to last 7 days
Args: period: Time period to look back (e.g., '3d', '1w', '2m', '1y'). Defaults to '7d' limit: Maximum number of entries to return. Defaults to 50
Inputs: limit, period. Returns: result
get_projectsC
Get all projects from Things
Args: include_items: Include tasks within projects
Inputs: include_items. Returns: result
get_recentC
Get recently created items
Args: period: Time period (e.g., '3d', '1w', '2m', '1y')
Inputs: period (required). Returns: result
get_somedayB
Get todos from Someday list
Inputs: no named parameters. Returns: result
get_tagged_itemsC
Get items with a specific tag
Args: tag: Tag title to filter by
Inputs: tag (required). Returns: result
get_tagsC
Get all tags
Args: include_items: Include items tagged with each tag
Inputs: include_items. Returns: result
get_todayB
Get todos due today
Inputs: no named parameters. Returns: result
get_todosB
Get todos from Things, optionally filtered by project
Args: project_uuid: Optional UUID of a specific project to get todos from include_items: Include checklist items
Inputs: include_items, project_uuid. Returns: result
get_trashB
Get trashed todos
Inputs: no named parameters. Returns: result
get_upcomingB
Get upcoming todos
Inputs: no named parameters. Returns: result
search_advancedB
Advanced todo search with multiple filters
Args: status: Filter by todo status (incomplete, completed, canceled) start_date: Filter by start date (YYYY-MM-DD) deadline: Filter by deadline (YYYY-MM-DD) tag: Filter by tag area: Filter by area UUID type: Filter by item type (to-do, project, heading)
Inputs: area, deadline, start_date, status, +2 more. Returns: result
search_itemsC
Search for items in Things
Args: query: Search query
Inputs: query (required). Returns: result
search_todosC
Search todos by title or notes
Args: query: Search term to look for in todo titles and notes
Inputs: query (required). Returns: result
show_itemB
Show a specific item or list in Things
Args: id: ID of item to show, or one of: inbox, today, upcoming, anytime, someday, logbook query: Optional query to filter by filter_tags: Optional tags to filter by
Inputs: id (required), filter_tags, query. Returns: result
update_projectB
Update an existing project in Things
Args: id: ID of the project to update title: New title notes: New notes when: New schedule deadline: New deadline tags: New tags completed: Mark as completed canceled: Mark as canceled
Inputs: id (required), canceled, completed, deadline, +4 more. Returns: result
update_todoB
Update an existing todo in Things
Args: id: ID of the todo to update title: New title notes: New notes when: New schedule deadline: New deadline tags: New tags completed: Mark as completed canceled: Mark as canceled list: The title of a project or area to move the to-do into list_id: The ID of a project or area to move the to-do into (takes precedence over list) heading: The heading title to move the to-do under heading_id: The heading ID to move the to-do under (takes precedence over heading)
Inputs: id (required), canceled, completed, deadline, +8 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Most tools have distinct purposes targeting specific resources like projects, todos, areas, or lists, with clear separation between creation, retrieval, and update operations. However, there is some overlap between search_items, search_todos, and search_advanced, which could cause confusion about which to use for different search scenarios.
Tool names follow a highly consistent verb_noun pattern throughout, with verbs like add, get, update, and search paired with specific nouns (e.g., add_project, get_areas, update_todo, search_items). All names use snake_case uniformly, making the set predictable and easy to navigate.
With 22 tools, the count is on the higher side for a task management server, bordering on heavy. While many tools serve distinct functions, the number might feel overwhelming compared to a more streamlined set, though it's not extreme given the domain's complexity.
The tool set provides comprehensive coverage for task management, including full CRUD operations for projects and todos, retrieval of various lists (e.g., inbox, today, upcoming), search capabilities, and management of related entities like areas, tags, and headings. No obvious gaps exist for core workflows.
Maintenance
Related MCP Connectors
Capture, clarify and plan your tasks from Claude or ChatGPT. Built around the GTD methodology.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Notes, tasks, habits, journal and 6 more tools Claude can read and change, with undo. Free.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceLets you use Claude Desktop to interact with your task management data in Things app, enabling you to create tasks, analyze projects, manage priorities, and implement productivity workflows through natural language.35MIT
- FlicenseBqualityDmaintenanceEnables Claude to interact with Things 3 on macOS, allowing users to create, update, and manage to-dos and projects, list tasks, search items, and navigate through Things lists using natural language.2016-
- AlicenseBqualityDmaintenanceEnables Claude to interact with Things 3 task management, allowing creation, analysis, and management of tasks, projects, and tags via natural language.22MIT
- AlicenseBqualityDmaintenanceEnables Claude to interact with Things 3 task management, allowing natural language task creation, project analysis, and GTD workflow automation.2473 PyPI44MIT