# How to integrate Microsoft Planner MCP with Atomic Agent

```json
{
  "title": "How to integrate Microsoft Planner MCP with Atomic Agent",
  "toolkit": "Microsoft Planner",
  "toolkit_slug": "microsoft_planner",
  "framework": "Atomic Agent",
  "framework_slug": "atomic-agent",
  "url": "https://composio.dev/toolkits/microsoft_planner/framework/atomic-agent",
  "markdown_url": "https://composio.dev/toolkits/microsoft_planner/framework/atomic-agent.md",
  "updated_at": "2026-11-12T05:34:30.968Z"
}
```

## 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](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions.

## Also integrate Microsoft Planner with

- [ChatGPT](https://composio.dev/toolkits/microsoft_planner/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/microsoft_planner/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/microsoft_planner/framework/hermes-agent)

## TL;DR

### 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

### Connect Microsoft Planner to Atomic Agent
- Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key.
- 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.
- Ask Atomic Agent to do something in Microsoft Planner. It searches Composio for the right tool.
- 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.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `MICROSOFT_PLANNER_BETA_ADD_ROSTER_MEMBER` | Beta: Add Roster Member | Beta, non-production API: add a same-tenant user with full control to a Planner roster. Microsoft Graph beta can change without notice. |
| `MICROSOFT_PLANNER_BETA_ASSIGN_ROSTER_SENSITIVITY_LABEL` | Beta: Assign Roster Sensitivity Label | Beta, non-production API: assign or change a roster sensitivity label using the latest roster ETag. Tenant label policy can reject the request, and Microsoft Graph beta can change without notice. |
| `MICROSOFT_PLANNER_BETA_CREATE_ROSTER` | Beta: Create Roster | Beta, non-production API: create an empty Planner roster. Microsoft Graph beta can change without notice, and an empty roster is automatically deleted after 24 hours if no plan is added. |
| `MICROSOFT_PLANNER_BETA_CREATE_ROSTER_PLAN` | Beta: Create Roster Plan | Beta, non-production API: create the single plan contained by a Planner roster. Roster containers and this route behavior can change without notice. |
| `MICROSOFT_PLANNER_BETA_DELETE_ROSTER` | Beta: Delete Roster | Beta, non-production API: permanently delete a Planner roster and cascade-delete its contained plan and tasks. Microsoft Graph beta can change without notice. |
| `MICROSOFT_PLANNER_BETA_GET_ROSTER` | Beta: Get Roster | Beta, non-production API: get a Planner roster and its current ETag. Microsoft Graph beta can change without notice. |
| `MICROSOFT_PLANNER_BETA_GET_ROSTER_MEMBER` | Beta: Get Roster Member | Beta, non-production API: get one Planner roster member. This action intentionally omits $select because it caused a live Microsoft Graph beta provider failure while the unfiltered read succeeded. |
| `MICROSOFT_PLANNER_BETA_LIST_ROSTER_MEMBERS` | Beta: List Roster Members | Beta, non-production API: list one page of members with full control of a Planner roster. Microsoft Graph beta can change without notice. |
| `MICROSOFT_PLANNER_BETA_LIST_ROSTER_PLANS` | Beta: List Roster Plans | Beta, non-production API: list one page containing the plan in a Planner roster. A roster can contain at most one plan, and Microsoft Graph beta can change without notice. |
| `MICROSOFT_PLANNER_BETA_LIST_USER_ROSTER_PLANS` | Beta: List User Roster Plans | Beta, non-production API: list one page of plans in rosters of which a specified user is a member. Only the explicit-user route is documented, and Microsoft Graph beta can change without notice. |
| `MICROSOFT_PLANNER_BETA_REMOVE_ROSTER_MEMBER` | Beta: Remove Roster Member | Beta, non-production API: remove a roster member. Removing the last member can delete the roster, its plan, and its tasks. Microsoft Graph beta can change without notice. |
| `MICROSOFT_PLANNER_CREATE_BUCKET` | Create Bucket | Create an ordered bucket in a Microsoft Planner plan. |
| `MICROSOFT_PLANNER_CREATE_PLAN` | Create Plan | Create a basic Planner plan in a Microsoft 365 group the connected user belongs to. |
| `MICROSOFT_PLANNER_CREATE_TASK` | Create Task | Create a Planner task with optional bucket placement, assignments, categories, dates, progress, and priority. |
| `MICROSOFT_PLANNER_DELETE_BUCKET` | Delete Bucket | Delete a Microsoft Planner bucket using its latest ETag. |
| `MICROSOFT_PLANNER_DELETE_PLAN` | Delete Plan | Permanently delete a Planner plan using its latest ETag. |
| `MICROSOFT_PLANNER_DELETE_TASK` | Delete Task | Delete a Planner task using its latest core-resource ETag. |
| `MICROSOFT_PLANNER_GET_ASSIGNED_TO_BOARD_FORMAT` | 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. |
| `MICROSOFT_PLANNER_GET_BUCKET` | Get Bucket | Get one Microsoft Planner bucket and its current resource ETag. |
| `MICROSOFT_PLANNER_GET_BUCKET_BOARD_FORMAT` | Get Bucket Board Format | Get a task's ordering hint for the bucket board and the format-specific ETag. |
| `MICROSOFT_PLANNER_GET_PLAN` | Get Plan | Get one basic Planner plan and its current resource ETag. |
| `MICROSOFT_PLANNER_GET_PLAN_DETAILS` | Get Plan Details | Get a plan's 25 category labels, shared-user dictionary, and details-specific ETag. |
| `MICROSOFT_PLANNER_GET_PLANNER_ENTRY_POINT` | Get Planner Entry Point | Return the Microsoft Graph Planner entry-point metadata; this documented singleton has no Planner data properties. |
| `MICROSOFT_PLANNER_GET_PROGRESS_BOARD_FORMAT` | Get Progress Board Format | Get a task's ordering hint for the progress board and the format-specific ETag. |
| `MICROSOFT_PLANNER_GET_TASK` | Get Task | Get a Planner task's complete core resource, including assignments, applied categories, progress, counts, identities, and its current core-resource ETag. |
| `MICROSOFT_PLANNER_GET_TASK_DETAILS` | Get Task Details | Get a task's separately versioned description, checklist, external references, preview mode, and task-details ETag. |
| `MICROSOFT_PLANNER_LIST_BUCKETS_BY_PLAN` | List Buckets by Plan | List one page of buckets through the root Planner collection using the live-verified planId filter grammar. Follow next_cursor even when items is empty. |
| `MICROSOFT_PLANNER_LIST_BUCKET_TASKS` | List Bucket Tasks | List one page of tasks currently associated with a Microsoft Planner bucket. |
| `MICROSOFT_PLANNER_LIST_DRIVE_CREATOR_PLANS` | List Drive Creator Plans | Call the documented drive-root creator traversal to list one page of that user's shared Planner plans. This exact route returned Microsoft Graph HTTP 500 during live probing, so prefer List My Plans when applicable. |
| `MICROSOFT_PLANNER_LIST_GROUP_PLANS` | List Group Plans | List one page of basic Planner plans owned by a Microsoft 365 group. |
| `MICROSOFT_PLANNER_LIST_MY_ASSIGNED_TASKS` | List My Assigned Tasks | List one page of Planner tasks assigned to the connected work or school user. |
| `MICROSOFT_PLANNER_LIST_MY_PLANS` | List My Plans | List one page of Planner plans shared with the connected work or school user. |
| `MICROSOFT_PLANNER_LIST_PLAN_BUCKETS` | List Plan Buckets | List one page of buckets in a Planner plan. |
| `MICROSOFT_PLANNER_LIST_PLANS_BY_OWNER` | List Plans by Owner | List one page of basic Planner plans owned by one Microsoft 365 group using the live-verified owner filter grammar. |
| `MICROSOFT_PLANNER_LIST_PLAN_TASKS` | List Plan Tasks | List one page of tasks in a Planner plan. |
| `MICROSOFT_PLANNER_LIST_TASKS_BY_PLAN` | List Tasks by Plan | List one page of Planner tasks through the root collection using the live-verified planId filter grammar. |
| `MICROSOFT_PLANNER_LIST_USER_ASSIGNED_TASKS` | List User Assigned Tasks | List one page of Planner tasks assigned to a specified work or school user. |
| `MICROSOFT_PLANNER_LIST_USER_PLANS` | List User Plans | List one page of Planner plans shared with a specified work or school user. |
| `MICROSOFT_PLANNER_UPDATE_ASSIGNED_TO_BOARD_FORMAT` | Update Assigned To Board Format | Update a task's ordering hints on the Assigned To board using that format resource's latest ETag. |
| `MICROSOFT_PLANNER_UPDATE_BUCKET` | Update Bucket | Change a bucket's name or board order using its latest ETag. |
| `MICROSOFT_PLANNER_UPDATE_BUCKET_BOARD_FORMAT` | Update Bucket Board Format | Update a task's ordering hint on the bucket board using that format resource's latest ETag. |
| `MICROSOFT_PLANNER_UPDATE_PLAN` | Update Plan | Change a plan title using its latest ETag and return the updated representation by default. |
| `MICROSOFT_PLANNER_UPDATE_PLAN_DETAILS` | Update Plan Details | Update any of a plan's 25 category labels or shared users using the plan-details ETag. |
| `MICROSOFT_PLANNER_UPDATE_PROGRESS_BOARD_FORMAT` | Update Progress Board Format | Update a task's ordering hint on the progress board using that format resource's latest ETag. |
| `MICROSOFT_PLANNER_UPDATE_TASK` | Update Task | Update any documented writable core task fields, including assignments, categories, dates, progress, priority, or bucket, using the latest task ETag. |
| `MICROSOFT_PLANNER_UPDATE_TASK_DETAILS` | Update Task Details | Update a task's description, preview mode, checklist items, or external references using the separately versioned task-details ETag. |

## Supported Triggers

None listed.

## 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](/pricing/platform) for the current limits that apply to your connection.

## Complete Code

None listed.

## Conclusion

### 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](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo).

## How to build Microsoft Planner MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/microsoft_planner/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/microsoft_planner/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/microsoft_planner/framework/hermes-agent)

## Related Toolkits

- [Google Sheets](https://composio.dev/toolkits/googlesheets) - Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly.
- [Notion](https://composio.dev/toolkits/notion) - Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place.
- [Airtable](https://composio.dev/toolkits/airtable) - Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations.
- [Asana](https://composio.dev/toolkits/asana) - Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals.
- [Google Tasks](https://composio.dev/toolkits/googletasks) - Google Tasks is a to-do list and task management tool integrated into Gmail and Google Calendar. It helps you organize, track, and complete tasks across your Google ecosystem.
- [Linear](https://composio.dev/toolkits/linear) - Linear is a modern issue tracking and project planning tool for fast-moving teams. It helps streamline workflows, organize projects, and boost productivity.
- [Jira](https://composio.dev/toolkits/jira) - Jira is Atlassian’s platform for bug tracking, issue tracking, and agile project management. It helps teams organize work, prioritize tasks, and deliver projects efficiently.
- [Clickup](https://composio.dev/toolkits/clickup) - ClickUp is an all-in-one productivity platform for managing tasks, docs, goals, and team collaboration. It streamlines project workflows so teams can work smarter and stay organized in one place.
- [Monday](https://composio.dev/toolkits/monday) - Monday.com is a customizable work management platform for project planning and collaboration. It helps teams organize tasks, automate workflows, and track progress in real time.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Agiled](https://composio.dev/toolkits/agiled) - Agiled is an all-in-one business management platform for CRM, projects, and finance. It helps you streamline workflows, consolidate client data, and manage business processes in one place.
- [Aha!](https://composio.dev/toolkits/aha) - Aha! is a product management platform for setting strategy, prioritizing ideas, and planning roadmaps. It helps product teams align goals with development work and make better decisions.
- [AirOps MCP](https://composio.dev/toolkits/airops_mcp) - AirOps MCP is AirOps' managed content platform exposing brand context, knowledge bases, and workflows. Use it to give agents brand-aware content, automate content workflows, and track Brand Kit edits.
- [Amazing Marvin](https://composio.dev/toolkits/amazing_marvin) - Amazing Marvin is a personal productivity app for tasks, projects, habits, planning, time tracking, and rewards. It helps you build a flexible workflow that matches how you actually work.
- [Ambiguous MCP](https://composio.dev/toolkits/ambiguous_mcp) - Ambiguous MCP is a provider-hosted workspace service for documents, spreadsheets, tasks, CRM, calendar, mail, chat, and administration. It provides one workspace-scoped connection for managing these resources through natural language.
- [AnyDB](https://composio.dev/toolkits/any_db) - AnyDB is a flexible collaborative database platform for organizing records, files, and automated workflows. It helps teams centralize data, collaborate on records, and automate routine tasks.
- [ApptiveGrid](https://composio.dev/toolkits/apptivegrid) - ApptiveGrid is a collaborative no-code database and app platform for spaces, grids, forms, and structured records. It helps teams organize operational data, collect inputs, and build lightweight business apps without custom backend work.
- [Ascora](https://composio.dev/toolkits/ascora) - Ascora is a cloud-based field service management platform for service businesses. It streamlines scheduling, invoicing, and customer operations in one place.
- [Atlassian MCP](https://composio.dev/toolkits/atlassian_mcp) - Atlassian Rovo MCP connects agents to Jira, Jira Service Management, Confluence, Bitbucket, Compass, and Teamwork Graph workflows. It lets teams surface and act on Atlassian data while respecting existing user permissions.
- [Basecamp](https://composio.dev/toolkits/basecamp) - Basecamp is a project management and team collaboration tool by 37signals. It helps teams organize tasks, share files, and communicate efficiently in one place.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Microsoft Planner MCP?

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.

### Can I use Tool Router MCP with Atomic Agent?

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.

### Can I manage the permissions and scopes for Microsoft Planner while using Tool Router?

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.

### How safe is my data with Composio Tool Router?

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.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)