Skip to main content
Glama
enesjakozh
turlockmike

apple-notifier-mcp

by turlockmike
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Servidor MCP de Apple Notifier

insignia de herrería Envía notificaciones nativas de macOS e interactúa con los cuadros de diálogo del sistema a través de cualquier cliente compatible con MCP como Claude Desktop o Cline.

Prerrequisitos

  • macOS

  • Node.js >= 18

  • Un cliente compatible con MCP (Claude Desktop, Cline)

Related MCP server: apple-notifier-mcp

Instalación

Instalación mediante herrería

Para instalar Apple Notifier para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install apple-notifier-mcp --client claude

Instalación manual

  1. Instalar el paquete globalmente:

npm install -g apple-notifier-mcp

  1. Agregue a su archivo de configuración de MCP:

Para Cline ( cline_mcp_settings.json ):

{
  "mcpServers": {
    "apple-notifier": {
      "command": "apple-notifier-mcp"
    }
  }
}

Para Claude Desktop ( claude_desktop_config.json ):

{
  "mcpServers": {
    "apple-notifier": {
      "command": "apple-notifier-mcp"
    }
  }
}

Características

Enviar notificaciones

Muestra notificaciones nativas de macOS con contenido personalizable.

Parámetros:

  • title (obligatorio): cadena: el título de la notificación

  • message (obligatorio): cadena: el contenido principal del mensaje

  • subtitle (opcional): cadena - Un subtítulo para mostrar

  • sound (opcional): booleano - Si se reproducirá el sonido de notificación predeterminado (predeterminado: verdadero)

Indicaciones de visualización

Muestra mensajes de diálogo interactivos para obtener información del usuario.

Parámetros:

  • message (obligatorio): cadena: texto que se mostrará en el cuadro de diálogo de solicitud

  • defaultAnswer (opcional): cadena - Texto predeterminado para rellenar previamente

  • buttons (opcional): string[] - Etiquetas de botones personalizadas (máximo 3)

  • icon (opcional): 'nota' | 'detener' | 'precaución' - Icono para mostrar

Texto a voz

Utilice las capacidades de texto a voz de macOS.

Parámetros:

  • text (obligatorio): cadena - Texto a leer

  • voice (opcional): cadena - Voz a utilizar (predeterminada: voz del sistema)

  • rate (opcional): número - Velocidad de voz (-50 a 50, predeterminado 0)

Tomar capturas de pantalla

Captura capturas de pantalla usando la captura de pantalla de macOS.

Parámetros:

  • path (obligatorio): cadena - Ruta donde guardar la captura de pantalla

  • type (obligatorio): 'pantalla completa' | 'ventana' | 'selección' - Tipo de captura de pantalla

  • format (opcional): 'png' | 'jpg' | 'pdf' | 'tiff' - Formato de imagen

  • hideCursor (opcional): booleano - Si se debe ocultar el cursor

  • shadow (opcional): booleano - Si se debe incluir la sombra de la ventana (solo para el tipo de ventana)

  • timestamp (opcional): booleano - Agrega una marca de tiempo al nombre del archivo

Selección de archivos

Abrir el cuadro de diálogo de selección de archivos nativos de macOS.

Parámetros:

  • prompt (opcional): cadena - Mensaje de aviso

  • defaultLocation (opcional): cadena - Ruta de directorio predeterminada

  • fileTypes (opcional): objeto - Filtro de tipo de archivo (por ejemplo, {"public.image": ["png", "jpg"]})

  • multiple (opcional): booleano - Permitir la selección de múltiples archivos

Ejemplo de uso

// Send a notification
await client.use_mcp_tool("apple-notifier", "send_notification", {
  title: "Hello",
  message: "World",
  sound: true
});

// Show a prompt
const result = await client.use_mcp_tool("apple-notifier", "prompt_user", {
  message: "What's your name?",
  defaultAnswer: "John Doe",
  buttons: ["OK", "Cancel"]
});

// Speak text
await client.use_mcp_tool("apple-notifier", "speak", {
  text: "Hello, world!",
  voice: "Samantha",
  rate: -20
});

// Take a screenshot
await client.use_mcp_tool("apple-notifier", "take_screenshot", {
  path: "screenshot.png",
  type: "window",
  format: "png"
});

// Select files
const files = await client.use_mcp_tool("apple-notifier", "select_file", {
  prompt: "Select images",
  fileTypes: {
    "public.image": ["png", "jpg", "jpeg"]
  },
  multiple: true
});

Contribuyendo

Consulte CONTRIBUTING.md para conocer la configuración y las pautas de desarrollo.

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

Available Tools

5 tools
prompt_userA

Display a dialog prompt to get user input

ParametersJSON Schema
NameRequiredDescriptionDefault
messageYesText to display in the prompt dialog
defaultAnswerNoOptional default text to pre-fill
buttonsNoOptional custom button labels (max 3)
iconNoOptional icon to display

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided. The description does not disclose blocking behavior (waits for user input) or any side effects. It adds no behavioral context beyond the basic action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single, front-loaded sentence with no wasted words. Fully earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple prompt tool with 4 params and no output schema, the description is mostly complete. It implies the return value (user input) but misses mentioning that the tool blocks execution until input is given.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with clear param descriptions. The tool description adds no additional meaning beyond what the schema provides, scoring baseline 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Display a dialog prompt') and purpose ('to get user input'). It distinguishes from sibling tools like 'send_notification' (no input) and 'select_file' (file selection).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for general text input but provides no explicit guidance on when to use vs alternatives or when not to use (e.g., if a simple notification suffices).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

select_fileB

Open native file picker dialog

ParametersJSON Schema
NameRequiredDescriptionDefault
promptNoOptional prompt message
defaultLocationNoOptional default directory path
fileTypesNoOptional file type filter (e.g., {"public.image": ["png", "jpg"]})
multipleNoWhether to allow multiple selection

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations present, so description must carry full burden. It only says 'Open native file picker dialog', omitting behavior like blocking, return values, cancellation handling, or permissions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence is appropriately sized and front-loaded, no extraneous content.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Lacks explanation of return value or behavior for a tool with no output schema and no annotations. Does not cover user interaction results.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline 3 applies. The description adds no additional meaning beyond what the schema already provides for each parameter.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states verb 'Open' and resource 'native file picker dialog', distinguishing it from sibling tools like prompt_user, send_notification, etc.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives; no when-not-to-use or context provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

send_notificationB

Send a notification on macOS using osascript

ParametersJSON Schema
NameRequiredDescriptionDefault
titleYesTitle of the notification
messageYesMain message content
subtitleNoOptional subtitle
soundNoWhether to play the default notification sound

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It specifies the platform ('macOS') but fails to describe the tool's behavior such as whether it is blocking, what it returns, or error conditions (e.g., if osascript is unavailable). Minimal disclosure beyond the platform.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no unnecessary words. It is appropriately front-loaded and efficient for its purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has 4 parameters (2 required) and no output schema or annotations. The description does not address return values, errors, or platform dependencies beyond mentioning macOS. This is insufficient for reliable agent invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description adds no additional meaning beyond the schema's param descriptions, which already cover title, message, subtitle, and sound.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('send a notification') and the resource ('macOS' via 'osascript'), and it is distinct from sibling tools which involve user prompts, file selection, speech output, and screenshots.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. There is no mention of scenarios or exclusion criteria, leaving the agent to infer based solely on the tool name and sibling context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

speakC

Speak text using macOS text-to-speech

ParametersJSON Schema
NameRequiredDescriptionDefault
textYesText to speak
voiceNoVoice to use (defaults to system voice)
rateNoSpeech rate (-50 to 50, defaults to 0)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden for behavioral details. It only states 'Speak text,' omitting any mention of side effects (e.g., audio output), blocking behavior, or system requirements, which is insufficient for safe invocation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that immediately conveys the tool's function. It is appropriately front-loaded without unnecessary words, though slightly more detail could be added without harming conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simplicity of the tool and the comprehensive schema, the description is minimally adequate. However, it lacks mention of return value or behavior, which would be expected for a tool with no output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema covers 100% of parameters with descriptions, so the baseline is 3. The description adds no additional meaning beyond what the schema already provides, but it does not detract either.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Speak') and the resource ('text using macOS text-to-speech'), making the purpose unambiguous. It is distinct from sibling tools like prompt_user or take_screenshot, though no explicit differentiation is provided.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is given on when to use this tool versus alternatives. There is no mention of context, prerequisites, or when not to use it, leaving the agent to infer usage from the name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

take_screenshotC

Take a screenshot using macOS screencapture

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYesPath where to save the screenshot
typeYesType of screenshot to take
formatNoImage format
hideCursorNoWhether to hide the cursor
shadowNoWhether to include the window shadow (only for window type)
timestampNoTimestamp to add to filename

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description bears full burden. Mentions 'macOS screencapture' to hint at system call, but fails to state that it saves to file, requires display permissions, or that it blocks execution. No behavioral traits disclosed beyond basic action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One sentence, no extra words, efficient. However, lacks structure (e.g., bullet points) that could improve readability for such a multi-param tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema and no annotations, description is too sparse. Does not explain return value (saved file path?), does not mention side effects (file write), and omits important nuances like when to use different screenshot types.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3. Description adds no extra meaning beyond what schema already provides for parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clear verb (take) and resource (screenshot) with specific underlying tool (macOS screencapture). Distinguishes from sibling tools which are all unrelated. Could mention the types of screenshots (fullscreen, window, selection) but schema covers that.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool vs alternatives. No explicit context for when to capture full screen vs window vs selection, or when to use timestamp feature.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

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

  1. 5 tool updatesv1.0.0
    • First observedprompt_user
    • First observedselect_file
    • First observedsend_notification
    • First observedspeak
    • First observedtake_screenshot
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.6/5.0

Scored across 5 tools

Disambiguation5/5

Each tool targets a distinctly different macOS capability: user input, file selection, notification, text-to-speech, and screenshot. No overlap in purpose.

Naming Consistency5/5

All tool names follow an imperative verb pattern with optional noun (e.g., prompt_user, select_file, send_notification, take_screenshot), and 'speak' fits as a single-verb imperative.

Tool Count5/5

With 5 tools covering common macOS interactions, the count is well-scoped for a utility server—not too many and not too few.

Completeness4/5

The set covers core macOS utilities (notification, dialogs, TTS, screenshot), though the server name suggests a narrower focus on notifications. Minor additions like clipboard or open URL could enhance completeness.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

Appeared in Searches