Skip to main content
Glama
Sign In
mcp-macos-popup

mcp-macos-popup

by vakandi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

mcp-macos-popup

MCP server for native macOS popup notifications, with multi-screen support.

It shows dark glassy popup cards on macOS and lets an AI agent target a specific display. On multi-monitor setups, it can list every screen and return the screen that currently has focus.

Tools

  • show_popup — quick notification popup

  • show_docs — larger Markdown popup

  • dismiss_all_popups — close all popups

  • list_screens — list connected displays

  • get_focused_screen — return the focused display

show_popup and show_docs accept an optional screen argument: display id, index, label, primary, or focused.

Related MCP server: MCPing

Install

npm install -g mcp-macos-popup

Or run directly:

npx mcp-macos-popup

Electron is installed automatically as a dependency.

MCP configuration

{
  "mcpServers": {
    "macos-popup": {
      "command": "mcp-macos-popup"
    }
  }
}

Usage

mcp-cli call macos-popup show_popup '{"title":"Elia","message":"the answer","level":"info","duration":10}'
mcp-cli call macos-popup list_screens '{}'
mcp-cli call macos-popup get_focused_screen '{}'

Multi-screen

If four displays are connected, call list_screens or get_focused_screen first, then pass the chosen display id as screen:

mcp-cli call macos-popup show_popup '{"title":"Elia","message":"hello","screen":"focused"}'

Development

npm install
npm run daemon

Available Tools

5 tools
dismiss_all_popupsA

Immediately close every popup currently shown on screen.

Inputs: no named parameters.

get_focused_screenA

Return the display that currently has focus, so a popup can be shown on the right screen.

Inputs: no named parameters.

list_screensA

List every connected macOS display, including ids, labels, sizes and which one is focused.

Inputs: no named parameters.

show_docsA

Show a larger documentation-style popup on Wael's macOS screen that renders MARKDOWN (headings, lists, code blocks, links, quotes). Use it to surface rich information: a summary report, API results, a changelog, key findings. Stays longer on screen than show_popup.

Inputs: title (required), markdown (required), level, screen, +2 more.

show_popupA

Show a quick notification popup on Wael's macOS screen via a native Electron window (dark glassy card, top-right, auto-dismiss). Use it to alert Wael of important information: task done, deploy finished, error found, etc.

Inputs: title (required), level, screen, source, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 5 tools

    Disambiguation4/5

    show_popup vs show_docs are the closest pair, but descriptions clearly separate them by content type (quick notification vs markdown) and duration. list_screens and get_focused_screen overlap since list_screens already reports focus, making the focused-only tool somewhat redundant, but each still has a distinct intent.

    Naming Consistency5/5

    All five tools follow a clean snake_case verb_noun pattern (list_screens, get_focused_screen, dismiss_all_popups, show_popup, show_docs). No mixed conventions or camelCase deviations.

    Tool Count5/5

    Five tools is well-scoped for a popup-display server: enumerate screens, get the active screen, show a quick popup, show a rich popup, and dismiss all. Each earns its place with no filler.

    Completeness4/5

    Core lifecycle is covered: discover screens, target the focused one, show two popup styles, and clear them. Minor gaps exist—no individual popup dismissal (only dismiss_all_popups) and no way to list currently active popups.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Automation MCP

      ashwwwin
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to automate macOS desktop tasks including mouse control, keyboard input, screenshots, window management, and UI interaction.
      10 npm
      415
      MIT

    • MCPing

      toolprint
      A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to send desktop notifications on macOS with rich formatting, urgency levels, and sound options.
      1
      28 npm
      1
      MIT

    • macos-desktop-control

      d-wwei
      A
      license
      Not graded
      quality
      D
      maintenance
      Provides native macOS desktop automation for AI agents, enabling screen capture, mouse/keyboard control, window management, and iOS/Android simulator control in both foreground and background modes without focus stealing.
      5
      MIT

    • mcp-macos-cua

      bradthebeeble
      A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to control macOS desktop apps via screenshots, mouse clicks, keyboard input, accessibility queries, and AppleScript.
      11
      12 npm
      MIT