Mcpal

Name: Mcpal
Author: mjkid221

@mjkid221

Repository Homepage

About Mcpal

Friendly Companion MCP. Get notified when your task is finished!

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcpal": {
      "command": "npx",
      "args": [
        "mcpal@latest"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCPal?

MCPal is a lightweight MCP server for native desktop notifications with action buttons, text replies, and LLM‑aware icons. It is compatible with any MCP client.

How to use MCPal?

Add MCPal to your MCP config manually (JSON or TOML) or via CLI for Codex or Claude Code. Then call the send_notification tool with parameters such as message, title, actions, dropdownLabel, and reply.

Key features of MCPal

Native desktop notifications with action buttons and text reply
LLM‑aware icons that detect the calling client
Input sanitization and truncation for reliability
Structured tool result contract with backward‑compatible text output
Custom app icon automatically configured during installation
Built‑in MCP instructions for proactive notification configuration

Use cases of MCPal

Notify when a long‑running task (build, test, deployment) completes
Ask for user approval or choice via action buttons (e.g., “Deploy” / “Cancel”)
Request free‑form text input from the user without switching apps
Provide task‑completion hooks for AI assistants to notify the user

FAQ from MCPal

What does MCPal do?

MCPal sends native desktop notifications from any MCP client, supporting action buttons, text replies, and client‑specific icons.

How do I install MCPal?

Add it to your MCP config with npx mcpal@latest (JSON/TOML) or use the CLI commands for Codex (codex mcp add mcpal -- npx -y mcpal@latest) or Claude Code (claude mcp add mcpal -- npx -y mcpal@latest).