ms-todo-only-mcp
Click on "Deploy 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., "@ms-todo-only-mcp list my task lists"
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.
Microsoft To Do-only MCP
Microsoft To Do를 읽기 전용으로만 가져오는 아주 얇은 MCP 래퍼입니다. 내부적으로 Softeria의 @softeria/ms-365-mcp-server를 실행하되, To Do 조회 도구와 Tasks.Read 권한만 노출합니다.
노출 도구
list-todo-task-listslist-todo-tasksget-todo-tasklist-todo-linked-resources
Related MCP server: microsoft-todo-mcp-server
빠른 시작
.env.example을 .env로 복사합니다.
cp .env.example .env처음 한 번 로그인합니다. Microsoft device-code 페이지가 Chrome 시크릿 새 창으로 열리고, 코드는 클립보드에도 복사됩니다.
npm run login로그인 계정 캐시를 확인합니다.
npm run verify권한이 Tasks.Read 하나만 남는지 확인합니다.
npm run permissionsMCP 서버를 stdio 모드로 실행합니다.
npm startMCP 클라이언트 설정 예시
mcp.example.json의 절대 경로를 본인 로컬 경로로 바꿔서 MCP 클라이언트 설정에 붙이면 됩니다.
{
"mcpServers": {
"ms-todo": {
"command": "node",
"args": [
"/absolute/path/to/ms-todo-only-mcp/bin/ms-todo-mcp.mjs"
]
}
}
}AI/Codex로 설치하기
다른 사람에게는 아래 프롬프트를 그대로 전달해도 됩니다.
이 저장소를 Microsoft To Do MCP로 설정해 주세요.
1. 저장소 루트에서 `.env.example`을 `.env`로 복사해 주세요.
2. `.env` 값은 아래처럼 유지해 주세요.
MS365_MCP_CLIENT_ID=6d381e43-6641-4a91-a452-d9352244d2b2
MS365_MCP_TENANT_ID=consumers
3. `.env`와 토큰 캐시는 커밋하거나 공유하지 마세요.
4. `npm run permissions`로 `Tasks.Read`만 요청하는지 확인해 주세요.
5. `npm run login`을 실행하고, 사용자가 Microsoft device-code 로그인 페이지에서 직접 로그인/동의하게 안내해 주세요.
6. 로그인 뒤 `npm start`로 MCP 서버를 실행할 수 있게 해 주세요.
주의: client id는 public client id라 secret이 아닙니다. client secret은 만들거나 요구하지 마세요.생산성 다마고치로 쓰기
Microsoft To Do를 데이터 소스로 사용해서 오늘 할 일 상태를 펫의 말투로 피드백받을 수 있습니다. MCP 연결 뒤 prompts/productivity-pet.md의 프롬프트를 Claude, Codex, 또는 MCP를 지원하는 AI에 붙여넣으세요.
바로 쓰는 요청 예시:
Microsoft To Do에서 오늘 할 일을 확인해서 생산성 다마고치 모드로 피드백해줘.
내 자기평가:
- 집중도 4/10
- 피로도 6/10설정
기본 .env.example은 개인 Microsoft 계정용입니다.
MS365_MCP_CLIENT_ID=6d381e43-6641-4a91-a452-d9352244d2b2
MS365_MCP_TENANT_ID=consumers이 client id는 public client id라 비밀이 아닙니다. 실제 access token, refresh token, 로컬 token cache는 절대 공유하면 안 됩니다.
기본 브라우저로 device-code 페이지를 열고 싶다면 .env에 다음을 추가합니다.
MS_TODO_MCP_BROWSER=default특정 계정만 허용하려면 다음을 추가할 수 있습니다.
MS365_MCP_EXPECTED_USERNAME=you@example.com참고
Softeria의 --verify-login은 내부적으로 Microsoft Graph /me를 호출합니다. 이 프로젝트는 최소 권한을 위해 User.Read를 요청하지 않으므로 /me 검증은 403이 날 수 있습니다. 대신 npm run verify는 캐시된 계정 목록만 확인합니다.
Microsoft Graph의 To Do API는 목록 조회에 GET /me/todo/lists, 특정 목록의 태스크 조회에 GET /me/todo/lists/{todoTaskListId}/tasks를 씁니다. Softeria 서버에는 이미 이 엔드포인트들이 선언되어 있어서, 직접 인증과 Graph 호출을 다시 구현하지 않고 도구 필터와 권한 필터만 씌우는 방식으로 유지합니다.
Softeria MCP server: https://github.com/Softeria/ms-365-mcp-server
Microsoft Graph To Do API: https://learn.microsoft.com/en-us/graph/api/resources/todo-overview
Available Tools
10 toolsget-todo-taskARead-only
Read the properties and relationships of a todoTask object.
💡 TIP: Returns a single To Do task. NOTE: $select is NOT supported — do not pass select parameter, Graph returns RequestBroker--ParseUri (400). Use $expand=linkedResources to include linked email/resource. Returns body content (HTML format), checklist items, and linked resources.
Inputs: todoTaskId (required), todoTaskListId (required), expand, select, +3 more.
list-accountsARead-only
List all Microsoft accounts configured in this server. Use this to discover available account emails before making tool calls. Reflects accounts added mid-session via --login.
Inputs: no named parameters.
list-todo-linked-resourcesARead-only
Get information of one or more items in a partner application, based on which a specified task was created. The information is represented in a linkedResource object for each item. It includes an external ID for the item in the partner application, and if applicable, a deep link to that item in the application.
💡 TIP: Lists resources linked to a To Do task (emails, URLs, etc.). Each linked resource has displayName, webUrl, applicationName, and externalId.
Inputs: todoTaskId (required), todoTaskListId (required), top, skip, +9 more.
list-todo-task-listsARead-only
Get a list of the todoTaskList objects and their properties.
💡 TIP: Lists all To Do task lists. Returns todoTaskList-id needed for all task operations. The default list is typically called 'Tasks'. NOTE: $select is NOT supported by this endpoint — do not pass select parameter, Graph returns 400.
Inputs: top, skip, count, expand, +7 more.
list-todo-tasksARead-only
Get the todoTask resources from the tasks navigation property of a specified todoTaskList.
💡 TIP: Lists tasks in a To Do list. Requires todoTaskList-id — use list-todo-task-lists to find it. NOTE: $select is NOT supported — do not pass select, Graph returns 400. Use $filter=status eq 'notStarted' or $filter=status eq 'completed' to filter by status. Use $top to limit results. Status values: 'notStarted', 'inProgress', 'completed', 'waitingOnOthers', 'deferred'.
Inputs: todoTaskListId (required), top, skip, count, +8 more.
loginC
Authenticate with Microsoft account
Inputs: force.
logoutB
Log out from Microsoft account
Inputs: no named parameters.
remove-accountA
Remove a Microsoft account from the cache. Accepts email address (e.g. user@outlook.com) or account ID. Use list-accounts to discover available accounts.
Inputs: account (required).
select-accountA
Select a Microsoft account as the default. Accepts email address (e.g. user@outlook.com) or account ID. Use list-accounts to discover available accounts.
Inputs: account (required).
verify-loginA
Check current Microsoft authentication status
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose: authentication tools (login, logout, etc.) are separate from task operations (get, list). No overlap between listing accounts, lists, tasks, or linked resources.
All tool names follow a consistent verb-noun pattern with lowercase and hyphens (e.g., get-todo-task, list-accounts, remove-account). Even login/logout are standard verb-only forms.
10 tools is appropriate for a To Do server, covering authentication (5 tools) and read operations (5 tools). Not excessive nor insufficient.
The server is read-only for tasks and lists; missing create, update, delete for tasks and linked resources. This significantly limits functionality for typical task management.
Related MCP Connectors
Create, list, and complete todo items through MCP.
Unofficial community ClickUp MCP via personal API token. Not affiliated with ClickUp.
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Related MCP Servers
- AlicenseBqualityCmaintenanceMCP server for Microsoft To Do via Microsoft Graph. MSAL device code flow, no client secret needed.128196 npm22MIT
- AlicenseAqualityBmaintenanceMCP server for Microsoft To Do that enables managing task lists, tasks, and checklist items via the Microsoft Graph API with zero-config authentication.132Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables MCP clients to list, view details of, and update Microsoft Planner tasks grouped by bucket.2MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server to read and manage your Microsoft To Do tasks through the Microsoft Graph To Do API.1MIT