Skip to main content
Glama

Microsoft To Do-only MCP

Microsoft To Do를 읽기 전용으로만 가져오는 아주 얇은 MCP 래퍼입니다. 내부적으로 Softeria의 @softeria/ms-365-mcp-server를 실행하되, To Do 조회 도구와 Tasks.Read 권한만 노출합니다.

노출 도구

  • list-todo-task-lists

  • list-todo-tasks

  • get-todo-task

  • list-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 permissions

MCP 서버를 stdio 모드로 실행합니다.

npm start

MCP 클라이언트 설정 예시

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 호출을 다시 구현하지 않고 도구 필터와 권한 필터만 씌우는 방식으로 유지합니다.

Available Tools

10 tools
get-todo-taskA
Read-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-accountsA
Read-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-resourcesA
Read-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-listsA
Read-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-tasksA
Read-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

    A3.7/5.0

    Scored across 10 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    10 tools is appropriate for a To Do server, covering authentication (5 tools) and read operations (5 tools). Not excessive nor insufficient.

    Completeness2/5

    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

    Related MCP Servers