cloud_pc_list_usersLABSCO SUMMARY
Cloud PC fixes without opening the admin portal.
The everyday Cloud PC actions are one call each: find the machine, reboot it, rename it, or reprovision it when it is past saving — and reprovision takes the OS version and the account type as arguments.
What it is
An MCP server over the Microsoft Graph API for Cloud PCs. Eight tools list the tenant's users and Cloud PCs, and act on a machine by ID: reboot, rename, troubleshoot, end grace period, reprovision, and read review status. Graph requests go out through curl.
What you get
- Every registered user, returned as JSON
- Every Cloud PC available to the tenant, returned as JSON
- A Cloud PC rebooted by ID
- A Cloud PC given a new display name
- A troubleshoot run against one Cloud PC
- The grace period ended for a Cloud PC
- The review status for a Cloud PC
- A Cloud PC reprovisioned onto windows10 or windows11, with the account set as standardUser or administrator
Requirements
A Microsoft Graph app registration with rights over Cloud PCs: its tenant id, client id and client secret go in the client config. Launched with uv against the project directory. curl must be present, since that is how the server sends Graph requests. MIT licensed.
Setup effort
Clone and run — clone the repository, then add the configuration for your client; uv runs the script from your clone, with nothing to build
USE CASES
01
Fixing a Cloud PC someone is complaining about
Find the machine in the tenant list, reboot it, and run the troubleshoot if that is not enough.
02
Handing a machine over to a new person
Reprovision onto the OS version you want with the right account type, then rename it to match.
03
Finding out which machine belongs to whom
The user list and the Cloud PC list together answer the question before you touch anything.
04
Dealing with a Cloud PC sitting in its grace period
Read the review status, then end the grace period when the decision is made.
8 tools
Listed in project docs. Your client may show a different list.
cloud_pc_listcloud_pc_rebootcloud_pc_renamecloud_pc_troubleshootcloud_pc_end_grace_periodcloud_pc_get_review_statuscloud_pc_reprovisionBEFORE YOU INSTALL
What to know first
Tools you get
8 tools named in the project's documentation.
Requires
- uv on PATH
- Python 3.12+
- curl on PATH
- MSGRAPH_TENANT_ID in your environment
- MSGRAPH_CLIENT_ID in your environment
- MSGRAPH_CLIENT_SECRET in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Clone the repository, then add the configuration for your client; uv runs the script from your clone, with nothing to build.
Server setup
TERMINAL
git clone https://github.com/complexdevel/mcp-cloud-pc.gitMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"mcp-cloud-pc": {
"command": "uv",
"args": [
"run",
"--directory",
"<YOUR_PATH_TO_PARENT_FOLDER_MCP_CLOUD>",
"mcp-cloud-pc.py"
],
"env": {
"MSGRAPH_TENANT_ID": "<YOUR_MSGRAPH_TENANT_ID>",
"MSGRAPH_CLIENT_ID": "<YOUR_MSGRAPH_CLIENT_ID>",
"MSGRAPH_CLIENT_SECRET": "<YOUR_MSGRAPH_CLIENT_SECRET>"
}
}
}
}
