Mcpal MCP Server

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

Basic information

About Mcpal MCP Server

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

Mcpal MCP Server config

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

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

Mcpal MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

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

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.

Comments

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct