How to integrate Microsoft Planner MCP with Hermes

Connect Hermes to Microsoft Planner MCP. List overdue tasks in your planner, create a bucket for launch tasks, and more using natural language, with authentication handled for you.

Microsoft Planner logoMicrosoft Planner
Oauth2

Microsoft Planner is a collaborative work management app for organizing plans, tasks, buckets, and team assignments. It helps teams coordinate work, track progress, and keep projects moving in Microsoft 365.

46 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Microsoft Planner account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Microsoft Planner with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Microsoft Planner with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Microsoft Planner

Ask your agent to connect to Microsoft Planner, or simply request any Microsoft Planner-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Microsoft Planner connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Microsoft Planner or request any Microsoft Planner-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Microsoft Planner MCP server, and what's possible with it?

The Microsoft Planner MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Microsoft Planner account. It provides structured and secure access to your plans, buckets, tasks, assignments, and task details, so your agent can create work plans, organize tasks, find assigned work, review task information, and remove outdated items on your behalf.

  • Plan and bucket organization: Have your agent create Planner plans, add ordered buckets, list plans shared with you or owned by a group, and update or remove buckets when your workflow changes.
  • Task creation and assignment: Direct your agent to create tasks with bucket placement, assignments, categories, due dates, progress, and priority, then list tasks across a plan or bucket.
  • Personal work tracking: Let the agent find your assigned tasks, list plans available to you, and retrieve tasks assigned to another work or school user.
  • Task details and board views: Instruct your agent to retrieve task descriptions, checklists, external references, applied categories, and ordering information for bucket, progress, or assignee boards.
  • Roster administration: Have your agent create and inspect Planner rosters, add or remove roster members, list roster plans, and create the plan contained in a roster.

Way Forward

With Microsoft Planner connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

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

Beta: Add Roster Member

Beta, non-production API: add a same-tenant user with full control to a Planner roster.

Beta: Assign Roster Sensitivity Label

Beta, non-production API: assign or change a roster sensitivity label using the latest roster ETag.

Beta: Create Roster

Beta, non-production API: create an empty Planner roster.

Beta: Create Roster Plan

Beta, non-production API: create the single plan contained by a Planner roster.

Beta: Delete Roster

Beta, non-production API: permanently delete a Planner roster and cascade-delete its contained plan and tasks.

Beta: Get Roster

Beta, non-production API: get a Planner roster and its current ETag.

Beta: Get Roster Member

Beta, non-production API: get one Planner roster member.

Beta: List Roster Members

Beta, non-production API: list one page of members with full control of a Planner roster.

Beta: List Roster Plans

Beta, non-production API: list one page containing the plan in a Planner roster.

Beta: List User Roster Plans

Beta, non-production API: list one page of plans in rosters of which a specified user is a member.

Beta: Remove Roster Member

Beta, non-production API: remove a roster member.

Create Bucket

Create an ordered bucket in a Microsoft Planner plan.

Create Plan

Create a basic Planner plan in a Microsoft 365 group the connected user belongs to.

Create Task

Create a Planner task with optional bucket placement, assignments, categories, dates, progress, and priority.

Delete Bucket

Delete a Microsoft Planner bucket using its latest ETag.

Delete Plan

Permanently delete a Planner plan using its latest ETag.

Delete Task

Delete a Planner task using its latest core-resource ETag.

Get Assigned To Board Format

Get a task's per-assignee and unassigned ordering hints for the Assigned To board, plus its format-specific ETag.

Get Bucket

Get one Microsoft Planner bucket and its current resource ETag.

Get Bucket Board Format

Get a task's ordering hint for the bucket board and the format-specific ETag.

Get Plan

Get one basic Planner plan and its current resource ETag.

Get Plan Details

Get a plan's 25 category labels, shared-user dictionary, and details-specific ETag.

Get Planner Entry Point

Return the Microsoft Graph Planner entry-point metadata; this documented singleton has no Planner data properties.

Get Progress Board Format

Get a task's ordering hint for the progress board and the format-specific ETag.

Get Task

Get a Planner task's complete core resource, including assignments, applied categories, progress, counts, identities, and its current core-resource ETag.

Get Task Details

Get a task's separately versioned description, checklist, external references, preview mode, and task-details ETag.

List Buckets by Plan

List one page of buckets through the root Planner collection using the live-verified planId filter grammar.

List Bucket Tasks

List one page of tasks currently associated with a Microsoft Planner bucket.

List Drive Creator Plans

Call the documented drive-root creator traversal to list one page of that user's shared Planner plans.

List Group Plans

List one page of basic Planner plans owned by a Microsoft 365 group.

List My Assigned Tasks

List one page of Planner tasks assigned to the connected work or school user.

List My Plans

List one page of Planner plans shared with the connected work or school user.

List Plan Buckets

List one page of buckets in a Planner plan.

List Plans by Owner

List one page of basic Planner plans owned by one Microsoft 365 group using the live-verified owner filter grammar.

List Plan Tasks

List one page of tasks in a Planner plan.

List Tasks by Plan

List one page of Planner tasks through the root collection using the live-verified planId filter grammar.

List User Assigned Tasks

List one page of Planner tasks assigned to a specified work or school user.

List User Plans

List one page of Planner plans shared with a specified work or school user.

Update Assigned To Board Format

Update a task's ordering hints on the Assigned To board using that format resource's latest ETag.

Update Bucket

Change a bucket's name or board order using its latest ETag.

Update Bucket Board Format

Update a task's ordering hint on the bucket board using that format resource's latest ETag.

Update Plan

Change a plan title using its latest ETag and return the updated representation by default.

Update Plan Details

Update any of a plan's 25 category labels or shared users using the plan-details ETag.

Update Progress Board Format

Update a task's ordering hint on the progress board using that format resource's latest ETag.

Update Task

Update any documented writable core task fields, including assignments, categories, dates, progress, priority, or bucket, using the latest task ETag.

Update Task Details

Update a task's description, preview mode, checklist items, or external references using the separately versioned task-details ETag.

FAQ

Frequently asked questions

With a standalone Microsoft Planner MCP server, the agents and LLMs can only access a fixed set of Microsoft Planner tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Microsoft Planner and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Microsoft Planner tools.

Yes, absolutely. You can configure which Microsoft Planner scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Microsoft Planner data and credentials are handled as safely as possible.

Start with Microsoft Planner.It takes 30 seconds.

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

Start building