How to integrate Microsoft Planner MCP with Atomic Agent

Connect Atomic Agent 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

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Microsoft Planner.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Microsoft Planner account. See the Atomic Agent documentation for installation instructions.

Also integrate Microsoft Planner with

How Atomic Agent connects to Microsoft Planner

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Microsoft Planner to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Microsoft Planner. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Microsoft Planner account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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.

Use Microsoft Planner from Atomic Agent

With your account connected, ask Atomic Agent to work with Microsoft Planner in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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. Atomic Agent 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