Use this tool to send an in-app notification to any user in the account. Notifications appear in the recipient's bell icon (notification center) and may also trigger an email depending on the user's notification preferences. You must provide the recipient's user ID, a target object ID, the notification text, and a target_type that determines how monday.com links the notification.

Use target_type: "Post" when the notification relates to an update or reply (provide the update/reply ID as target_id). Use target_type: "Project" when the notification relates to an item or board (provide the item or board ID as target_id). To notify yourself, first call get_user_context or list_users_and_teams with getMe: true to retrieve your user ID.

Parameters

Example

Send a notification to user 48202303 linking to item 11971936030:

{
  "user_id": "48202303",
  "target_id": "11971936030",
  "text": "Testing the MCP create_notification tool for documentation purposes.",
  "target_type": "Project"
}

The tool confirmed the notification was sent to user 48202303 with the specified text.

Notify a user about a specific update:

{
  "user_id": "66347492",
  "target_id": "5179486006",
  "text": "You were mentioned in an update on the Design homepage mockup item.",
  "target_type": "Post"
}

Programmatic equivalent

Use the GraphQL API to achieve the same result:

mutation {
  create_notification(
    user_id: 48202303
    target_id: 11971936030
    text: "Testing the create_notification mutation."
    target_type: Project
  ) {
    text
  }
}

For full documentation, see Notifications.