1. Docs
2. /
3. Tool reference
4. /
5. Apps & Assets
6. /
7. setHomeScreenPin

Apps & Assets

setHomeScreenPin

Set HomeScreen Pin

Add or remove an app on the caller’s HomeScreen when they explicitly choose its placement.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "add to HomeScreen", and it calls setHomeScreenPin.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "appId": "<appId>",
    "pinned": true
  },
  "name": "setHomeScreenPin"
}

Arguments

• appIdstringrequiredNo description is declared in the tool schema.
• pinnedbooleanrequiredNo description is declared in the tool schema.

Returns

The registry does not declare a return shape.

Ask for it

The Cloud routes these requests to this verb.

• add to HomeScreen
• remove from HomeScreen
• put this app on my home screen

Pair it with

The verbs that finish the job.

• listApps
• addAppToLibrary

Questions

• What does setHomeScreenPin do?

  Add or remove an app on the caller’s HomeScreen when they explicitly choose its placement. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use setHomeScreenPin from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "add to HomeScreen", and it calls setHomeScreenPin.

• Is setHomeScreenPin safe to let an AI call?

  setHomeScreenPin changes your workspace. What an AI creates is Private until you share it.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.