Mcpal

Q: 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`).

Q: What parameters does `send_notification` accept?

Required: `message` (string). Optional: `title` (default “MCPal”), `actions` (array of strings), `dropdownLabel` (string), `reply` (boolean).

Q: What are the input limits for notifications?

Title: 256 characters. Message: 4000 characters. Actions: max 3 items, each 64 characters. Dropdown label: 64 characters.

@mjkid221

Repository Homepage

About Mcpal

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

Config

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

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

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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).

What parameters does `send_notification` accept?

Required: message (string). Optional: title (default “MCPal”), actions (array of strings), dropdownLabel (string), reply (boolean).

Does MCPal support custom client icons?

Yes. To add a new client icon, place a 128×128 PNG (<10 KB) in src/assets/clients/ and update the mapping in src/notify.config.ts.

What are the input limits for notifications?

Title: 256 characters. Message: 4000 characters. Actions: max 3 items, each 64 characters. Dropdown label: 64 characters.

Frequently asked questions

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`).