1. Docs
2. /
3. Tool reference
4. /
5. Linear
6. /
7. readLinearNotifications

Linear

readLinearNotifications

Read Linear Notifications

Read one page of the connected Linear user's own inbox, newest first: each notification's type (issueNewComment, issueStatusChanged, issueMention, issueAssignedToYou), category (commentsAndReplies,…

readexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "my Linear inbox", and it calls readLinearNotifications.

Example call

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

{
  "arguments": {},
  "name": "readLinearNotifications"
}

Arguments

• workspacestringoptionalLinear workspace to act in (its name or URL key). Optional when only one workspace is connected.
• cursorstringoptionalOpaque next-page cursor returned by the previous call.
• pageSizeintegeroptionalItems per page, from 1 to 50. Defaults to 20.
• unreadOnlybooleanoptionalOnly unread notifications from the page read.

Returns

The registry does not declare a return shape.

Declared limits

• pageSize: minimum 1
• pageSize: maximum 50

Ask for it

The Cloud routes these requests to this verb.

• my Linear inbox
• any new comments on my tickets?
• what changed in Linear since I last looked?

Pair it with

The verbs that finish the job.

• markLinearNotification
• getLinearIssue

Questions

• What does readLinearNotifications do?

  Read one page of the connected Linear user's own inbox, newest first: each notification's type (issueNewComment, issueStatusChanged, issueMention, issueAssignedToYou), category (commentsAndReplies,… It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use readLinearNotifications 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 "my Linear inbox", and it calls readLinearNotifications.

• Is readLinearNotifications safe to let an AI call?

  readLinearNotifications is read-only: it changes nothing. It reaches a system outside The Cloud on your behalf.

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.