Skip to the content
2 layers68.6 × 53.3 mmNotifications shield, the printed circuit board in 3D

Notifications shield

arush-garg/ClaudeNotifications

Physical notifications (OLED display + buzzer) for any MCP-capable agent. Prevents leaving an agent working only to find it waiting for input.

Size
68.6 × 53.3 mm
Copper layers
2
Thickness
1.6 mm
Parts
15
Nets
8
Pads
55
Tracks, vias
56, 0
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
25 Aug 2026
Updated
8 Sep 2026

Overview

Notifications shield is an open-source printed circuit board by arush-garg, from the arush-garg/ClaudeNotifications repository on GitHub. It is a 2-layer board of 68.6 × 53.3 mm with 15 parts on 8 nets, routed with 56 tracks and 0 vias.

Its parts include 5 connectors, 2 capacitors, 1 resistor, 1 transistor and 1 switch.

README

README.md

Hardware Notifications MCP Server

Physical notifications (OLED display + buzzer) for any MCP-capable agent. Prevents leaving an agent working only to find it waiting for input.

Quick Start

  1. Build the circuit (see Wiring below)
  2. Install ClaudeNotifications: curl -sSL https://raw.githubusercontent.com/arush-garg/ClaudeNotifications/refs/heads/main/setup.sh | bash (this installs it globally to ~/.notifications/. If you want to install it in a project, add --local flag and run it inside your project directory.)
  3. Edit config.json
  4. Add MCP to your agent config (see below)
  5. Connect the microcontroller to your computer
Notes
  1. Installing the MCP server with setup.sh also installs the Arduino CLI and adds it to your path
  2. Installing the MCP server also adds hooks to your agent (Claude Code only for now). You can manually add hooks to your agent if you want to use the notifications server with other agents (see below)
  3. The MCP server will automatically compile and upload the Arduino firmware on first run (or when config.json changes)

Configure

Edit config.json at project root:

json
{
  "baud_rate": 9600,
  "screen_width": 128,
  "screen_height": 64,
  "text_size": 1,
  "text_color": "white",
  "num_beeps": 3,
  "notification_duration": 60,
  "buzzer_pin": 8,
  "serial_port": "/dev/cu.usbmodem2101"
}

MCP Client Integration

json
{
  "mcpServers": {
    "notifications": {
      "command": "uv",
      "args": ["run", "--project", "<PATH_TO_NOTIFICATIONS_SERVER>", "--directory", "<PATH_TO_NOTIFICATIONS_SERVER>", "python", "main.py"]
    }
  }
}

Don't worry about finding the correct path to the notifications server. The setup.sh script will print it out for you after installation.

Exposed Tools

ToolDescription
send_notification(message, beeps, duration)Show message on OLED, beep buzzer
get_status()Check hardware connection
flash_firmware(port)Compile & upload Arduino firmware

Hook Integration (Claude Code)

Auto-notify when agent asks clarifying questions:

.claude/settings.json (global) or .claude/settings.local.json (project)

json
{
  "hooks": {
    "PreToolUse": [{
      "matcher": "AskUserQuestion",
      "hooks": [{
        "type": "command",
        "command": "python3 /path/to/project/.claude/hooks/ask.py"
      }]
    }]
  }
}

It is possible to add hooks for other agents. You might have to edit hooks/ask.py to match your agent's tool format.

Wiring

text
Arduino Uno          SSD1306 OLED
─────────────────    ────────────────
5V                 → VCC
GND                → GND
A4 (SDA)           → SDA
A5 (SCL)           → SCL

Arduino Uno          Buzzer
─────────────────    ──────────────
Pin 9                → +
GND                  → -

Arduino Uno          Push Button
─────────────────    ────────────────
Pin 12                → One side of button
GND                  → Other side of button

Wiring Diagram

Parts

15
QtyValueFootprintReferences
4MountingHole_3.2mmArduino_MountingHole:MountingHole_3.2mmMH1, MH2, MH3, MH4
1100nC_Disc_D5.0mm_W2.5mm_P2.50mmC1
110uC_Radial_D5.0mm_H5.0mm_P2.00mmC2
11kR_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR1
12N3904TO-92_InlineQ1
1AnalogConnector_PinSocket_2.54mm:PinSocket_1x06_P2.54mm_VerticalJ4
1DISMISSSW_PUSH_6mmSW1
1Digital/PWMConnector_PinSocket_2.54mm:PinSocket_1x10_P2.54mm_VerticalJ2
1Digital/PWMConnector_PinSocket_2.54mm:PinSocket_1x08_P2.54mm_VerticalJ3
1OLED GND 5V SCL SDAPinHeader_1x04_P2.54mm_VerticalJ5
1PASSIVE PIEZOBuzzer_12x9.5RM7.6BZ1
1PowerConnector_PinSocket_2.54mm:PinSocket_1x08_P2.54mm_VerticalJ1

Similar boards

  • 2 layers19 × 76 mmSub, the printed circuit board in 3D

    Sub

    google/mozc-devices

    Circuit diagrams and firmware source code for Gboard DIY keyboards

    15 parts3kApache-2.0
  • 2 layers26.7 × 62.2 mmDeniseadapter, the printed circuit board in 3D

    Deniseadapter

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    15 parts1kGPL-3.0
  • 2 layers100 × 44 mmVideoslot, the printed circuit board in 3D

    Videoslot

    mntmn/amiga2000-gfxcard

    MNT VA2000, an Open Source Amiga 2/3/4000 Graphics Card (Zorro II/III), written in Verilog

    15 parts1k
  • 2 layers91 × 51 mmBusinessCard, the printed circuit board in 3D

    BusinessCard

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    15 parts915
  • 2 layers24.3 × 57.9 mmFlosspods pro flex, the printed circuit board in 3D

    Flosspods pro flex

    kenp-io/not-for-airpods-repairs

    The content of this repository is licensed under the WTFPL License. Please have a close look at the terms before using this material.

    15 parts609WTFPL
  • 2 layers20.3 × 15.2 mmL0 Load, the printed circuit board in 3D

    L0 Load

    Luos-io/luos_engine

    Open-source and real-time orchestrator for cyber-physical-systems, to easily design, test and deploy embedded applications and digital twins.

    15 parts546MIT
  • 2 layers68 × 50 mmEleLab v2 PowerFeed, the printed circuit board in 3D

    EleLab v2 PowerFeed

    Chrismettal/EleLab_v2

    Cheap DIY lab system for hobbyists and the tinkering folk

    15 parts531GPL-3.0
  • 2 layers50.8 × 35.6 mmInterface, the printed circuit board in 3D

    Interface

    harbaum/I2C-Tiny-USB

    Cheap and simple I²C to USB interface

    15 parts454

Questions

How big is the Notifications shield PCB?

It measures 68.6 × 53.3 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Notifications shield use?

15 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Notifications shield KiCad files?

From the arush-garg/ClaudeNotifications repository on GitHub, at the commit this page was made from: the board is kicad/notifications_shield.kicad_pcb and its schematic kicad/notifications_shield.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Notifications shield design in my own project?

Its repository states no licence, so its author keeps all rights: ask arush-garg before reusing the design.