Microsoft To Do MCP

Setup Instructions

1. Prerequisites

• Node.js 16 or higher

• npm

• A Microsoft account

• Azure App Registration (see setup below)

2. Installation

1. Installing the package

2. Setting up authentication (requires cloning the repository)

Step 1: Install the Package

Step 2: Set Up Authentication

3. Azure App Registration

1. Go to the [Azure Portal](https://portal.azure.com)

2. Navigate to "App registrations" and create a new registration

3. Name your application (e.g., "To Do MCP")

4. For "Supported account types", select one of the following based on your needs: - **Accounts in this organizational directory only (Single tenant)** - For use within a single organization - **Accounts in any organizational directory (Any Azure AD directory - Multitenant)** - For use across multiple organizations - **Accounts in any organizational directory and personal Microsoft accounts** - For both work accounts and personal accounts

5. Set the Redirect URI to `http://localhost:3000/callback`

6. After creating the app, go to "Certificates & secrets" and create a new client secret

7. Go to "API permissions" and add the following permissions: - Microsoft Graph > Delegated permissions: - Tasks.Read - Tasks.ReadWrite - User.Read

8. Click "Grant admin consent" for these permissions

4. Configuration

• `organizations` - For multi-tenant organizational accounts (default if not specified)

• `consumers` - For personal Microsoft accounts only

• `common` - For both organizational and personal accounts

• `your-specific-tenant-id` - For single-tenant configurations

Usage

Complete Workflow

1. **Authenticate to get tokens** (must be done from the cloned repository) ```bash npm run auth ``` This will open a browser window for you to authenticate with Microsoft and create a `tokens.json` file.

2. **Create MCP config file** (must be done from the cloned repository) ```bash npm run create-config ``` This creates an `mcp.json` file with your authentication tokens.

3. **Set up the global MCP configuration** ```bash # Copy the mcp.json file to your global Cursor configuration directory cp mcp.json ~/.cursor/mcp-servers.json ``` This makes the Microsoft To Do MCP available across all your Cursor projects.

4. **Start using with your AI assistant** - In Cursor, you can now use Microsoft To Do commands directly in any project - Try commands like `auth status` or `list up todos` to get started

• **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

• **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

• **Linux**: `~/.config/Claude/claude_desktop_config.json`

Available Tools

• `auth-status`: Check your authentication status

• `get-task-lists`: Get all your To Do task lists

• `create-task-list`: Create a new task list

• `update-task-list`: Update an existing task list

• `delete-task-list`: Delete a task list

• `get-tasks`: Get all tasks in a list

• `create-task`: Create a new task

• `update-task`: Update an existing task

• `delete-task`: Delete a task

• `get-checklist-items`: Get checklist items for a task

• `create-checklist-item`: Create a checklist item

• `update-checklist-item`: Update a checklist item

• `delete-checklist-item`: Delete a checklist item

Limitations

• The API requires proper authentication and permissions

• Rate limits may apply according to Microsoft's policies

Troubleshooting

Authentication Issues

• **"MailboxNotEnabledForRESTAPI" error**: This typically means you're using a personal Microsoft account. Microsoft To Do API access is limited for personal accounts through the Graph API.

• **Token acquisition failures**: Make sure your `CLIENT_ID`, `CLIENT_SECRET`, and `TENANT_ID` are correct in your `.env` file.

• **Permission issues**: Ensure you have granted admin consent for the required permissions in your Azure App registration.

Account Type Issues

• **Work/School Accounts**: These typically work best with the To Do API. Use `TENANT_ID=organizations` or your specific tenant ID.

• **Personal Accounts**: These have limited access to the To Do API. If you must use a personal account, try `TENANT_ID=consumers` or `TENANT_ID=common`.

Checking Authentication Status