A professional skill for AI agents to manage Microsoft To Do tasks and lists through the Microsoft Graph API using secure device-code authentication.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install microsoft-graph-todo
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install microsoft-graph-todo using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Microsoft To Do?
This skill provides a robust interface for AI coding agents to interact with Microsoft To Do, enabling full management of personal and organizational task lists. By utilizing Openclaw Skills, developers can integrate task automation directly into their AI workflows, allowing agents to read, create, update, and complete tasks seamlessly. It is designed to work with both personal Microsoft accounts and Entra-backed work or school accounts, providing a unified way to handle productivity across different Microsoft ecosystems.
The skill emphasizes security and best practices by using delegated permissions and storing secrets in OS-native configuration directories. This ensures that sensitive information like bearer tokens and client IDs are handled outside of shell history or source control. Whether you are building a personal assistant or a complex project management agent, leveraging this implementation within Openclaw Skills ensures reliable connectivity to the Microsoft Graph.
Microsoft To Do Use Cases
- Automatically listing all Microsoft To Do task lists to organize project requirements.
- Reading specific tasks from a list to provide status updates to the user.
- Creating new tasks directly from AI agent conversations or code analysis.
- Updating task importance or status to keep to-do items synchronized with development progress.
- Marking tasks as completed once the AI agent finishes a specific objective.
How Microsoft To Do Works
- The user registers a public client application in the Microsoft Entra ID portal to obtain the necessary client and tenant IDs.
- The skill uses a Python-based helper script to initiate the OAuth 2.0 device-code authentication flow.
- Upon successful browser-based sign-in, the script polls the Microsoft identity platform to retrieve and store access and refresh tokens locally.
- The AI agent invokes the skill, which extracts the current bearer token to authorize requests to Microsoft Graph endpoints.
- The skill executes REST API calls (GET, POST, PATCH, DELETE) to manage tasks and lists according to the agent's instructions.
Microsoft To Do Setup
To get started with this skill in the Openclaw Skills ecosystem, follow these steps:
- Create a New Registration in the Microsoft Entra ID portal and set the account type to include personal accounts if needed.
- Enable public client flows in the Authentication tab of your Azure app registration.
- Add the
Tasks.ReadWritedelegated permission under API Permissions. - Initialize your local configuration directory:
mkdir -p ~/.config/microsoft-todo
echo "YOUR_TENANT_ID" > ~/.config/microsoft-todo/tenant_id
echo "YOUR_CLIENT_ID" > ~/.config/microsoft-todo/client_id
- Run the device-code authentication process:
python3 scripts/ms_todo_auth.py device-code
- Complete the sign-in at the provided URL and then poll for your token:
python3 scripts/ms_todo_auth.py poll-token
Microsoft To Do Data Schema & Taxonomy
The skill manages configuration and state through a structured filesystem approach. It prioritizes OS-native directories to align with modern security standards for Openclaw Skills.
| Item | Location / Format | Purpose |
|---|---|---|
| Config Directory | ~/.config/microsoft-todo |
Primary storage for application identity and secrets. |
tenant_id |
Plain text file | Stores the Directory (tenant) ID or consumers. |
client_id |
Plain text file | Stores the Application (client) ID. |
token.json |
JSON Object | Stores access tokens, refresh tokens, and expiration metadata. |
device_code.json |
JSON Object | Temporary storage for active device-code auth sessions. |
| Task Data | JSON API Response | Standard Microsoft Graph Task schema including title, importance, and status. |
Microsoft To Do Advanced Features
- Support for refresh-token exchange to ensure long-running AI agent sessions remain authenticated.
- Cross-platform path resolution for Linux, macOS, and Windows configuration directories.
- Environment variable overrides for advanced CI/CD or containerized deployments of Openclaw Skills.
- Granular task manipulation including importance levels and progress tracking.
- Helper scripts that summarize token data to prevent accidental exposure of raw secrets in logs.
SKILL.md
Loading
Related Openclaw Skills
Astro Transits
A comprehensive astrology engine for AI agents to calculate planetary transits and natal chart aspects using the Swiss Ephemeris.
Life Capture
A sophisticated personal information manager that converts messy natural language entries into structured daily notes and a relational SQLite database.
SEO Audit Report
An automated SEO auditing tool that generates prioritized, scored reports covering technical, on-page, and content health.
Log Analyzer
A privacy-focused local log analysis system for identifying errors, duplicates, and system anomalies through interactive visualizations.
Feishu File Send
A specialized skill for sending images, audio, documents, and other file types directly to Feishu channels via automated workflows.
willhaben-search
A semantic search API for Austria's largest classifieds platform, enabling AI agents to find, browse, and analyze marketplace listings.
Featured*
