Microsoft To Do MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Microsoft To Do MCP or direct API to create tasks, manage task lists, update checklist items, and set reminders through natural language.

Microsoft To Do logoMicrosoft To Do
Oauth2

Microsoft To Do is Microsoft’s cloud task management app for lists, tasks, checklist items, reminders, and due dates. It keeps personal and team work organized across devices through Microsoft Graph.

22 Tools

Try Microsoft To Do now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Microsoft To Do
Try asking
TOOLS

Supported Tools

Every Microsoft To Do action and event your agent gets out of the box.

Complete Task

Mark a Microsoft To Do task as completed.

Create Checklist Item

Add a checklist item (subtask) to a Microsoft To Do task.

Create Task

Create a task in a Microsoft To Do task list.

Create Task List

Create a new Microsoft To Do task list.

Delete Checklist Item

Delete a checklist item (subtask) from a Microsoft To Do task.

Delete Task

Delete a task from a Microsoft To Do task list.

Delete Task Attachment

Permanently delete a file attachment from a Microsoft To Do task.

Delete Task List

Delete a Microsoft To Do task list.

Download Task Attachment

Download one file attached to a Microsoft To Do task.

Get Checklist Item

Get a single Microsoft To Do checklist item (subtask) by its id, within a task in a task list.

Get Current User

Return the profile of the Microsoft account connected to this toolkit (whoami / connection verification).

Get Task

Get a single Microsoft To Do task by its id, within a task list.

Get Task Attachment

Get metadata for one file attached to a Microsoft To Do task.

Get Task List

Get a single Microsoft To Do task list by its id.

List Checklist Items

List the checklist items (subtasks) of a To Do task.

List Task Attachments

List the files attached to a Microsoft To Do task.

List Task Lists

List the To Do task lists owned by the connected user.

List Tasks

List the tasks in a To Do task list.

Update Checklist Item

Update a checklist item (subtask) of a Microsoft To Do task: rename it (display_name) and/or check/uncheck it (is_checked).

Update Task

Update fields of an existing Microsoft To Do task (title, notes, importance, status, due/start/reminder dates, categories).

Update Task List

Rename a Microsoft To Do task list (updates its displayName).

Upload Task Attachment

Attach a file up to 25 MB to a Microsoft To Do task.

SETUP GUIDE

Connect Microsoft To Do MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Microsoft To Do
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'List overdue Microsoft To Do tasks from all my task lists'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Microsoft To Do API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Microsoft To Do Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a Microsoft To Do task named Submit expense report in my Tasks list due tomorrow'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Microsoft To Do actions with your Agent

Why Use Composio?

AI Native Microsoft To Do Integration

  • Supports both Microsoft To Do MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable task, list, and reminder actions
  • Rich coverage for reading, writing, and querying Microsoft To Do data through Microsoft Graph

Managed Auth

  • OAuth handling with secure token storage and lifecycle management
  • Central place to manage, scope, and revoke Microsoft To Do access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are shaped so AI agents can understand Microsoft To Do tasks, lists, due dates, and reminders clearly
  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Microsoft To Do
  • Scoped, least privilege access to task lists, tasks, checklist items, and reminders
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Microsoft To Do requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Microsoft To Do.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Microsoft To Do tool your agent needs.Free to start.

Start building