NockIt — Push Notifications for AI Coding Agents (MCP

Q: How do I install NockIt?

Run npx -y nockit-mcp setup in your terminal, choose a topic name, subscribe to it in the ntfy app on your phone, then restart your agent. Total setup time is about 60 seconds.

Q: What kinds of notifications will I receive?

Three types: completed when a task finishes, needs_input when the agent is blocked and waiting for you, and failed when an unrecoverable error stops the agent.

How it works

Three steps. Zero babysitting.

1

Your agent runs

Claude Code, Cursor, OpenCode — whatever you're using. NockIt hooks in via MCP.

2

Something happens

Task completes, error hits, or the agent needs your input. NockIt catches it.

3

Your phone buzzes

A push notification lands on your phone via ntfy. You're free to walk away.

Instant Pushes

Real-time notifications powered by ntfy. No accounts, no servers, no middlemen.

MCP Native

Works with OpenCode, Claude Code, Cursor, and any MCP-compatible client.

Private Topics

Each setup generates a unique topic. No accounts needed. Only you see your alerts.

Zero Backend

Runs entirely on your machine. No servers to manage, no data leaves your laptop.

Get started

60-second setup

1

Run the setup

This interactive command creates your notification topic and configures your agent.

npx -y nockit-mcp setup

2

Choose your topic

Pick a topic name or let NockIt generate a random private one. You'll see a URL like:

https://ntfy.sh/nockit_a1b2c3d4

3

Subscribe on your phone

This is the important part. You need to subscribe to your topic so notifications reach your phone:

4

Restart your agent session

Restart OpenCode, Claude Code, or your MCP client. NockIt will now automatically ping you.

Notification types

What you'll get pinged for

completed

Agent finished a task, long-running operation, or multi-step edit.

needs_input

Agent is blocked and waiting for your decision, answer, or credentials.

failed

Unrecoverable error stopped the agent. Something needs your attention.

CLI reference

Command line

npx nockit setup

Interactively configure your topic, rules, and agent settings. Pass --force to reconfigure.

npx nockit status

Show your active topic, ntfy URL, and configuration file paths.

npx nockit send

Push a manual notification from your terminal or shell scripts.

Manual send examples

# Task done
npx nockit send --status completed --summary "Build and tests passed!"

# Need user input
npx nockit send --status needs_input --summary "API key required for Stripe integration."

# Something broke
npx nockit send --status failed --summary "Database migration failed on line 42."

FAQ

Frequently asked questions

What is NockIt?

NockIt is a free, open-source MCP server and CLI that sends push notifications to your phone when your AI coding agent finishes a task, hits an error, or needs your input. It connects your agent to ntfy, a free push notification service.

How does NockIt work?

NockIt hooks into AI coding agents through the Model Context Protocol (MCP). When your agent finishes, fails, or waits for input, NockIt sends a push notification to your phone via ntfy. No servers to run and no accounts to create.

Which AI coding agents are supported?

NockIt works with any MCP-compatible client, including OpenCode, Claude Code, Cursor, and Zed.

Does NockIt require a server or an account?

No. NockIt runs entirely on your machine and uses ntfy.sh, a free public push service. No account is needed, and only the notification message leaves your laptop.

Is NockIt free?

Yes. NockIt is MIT-licensed open source and free to use, and push notifications via ntfy.sh are free as well.

How do I install NockIt?

Run npx -y nockit-mcp setup in your terminal, choose a topic name, subscribe to it in the ntfy app on your phone, then restart your agent. Total setup time is about 60 seconds.

What kinds of notifications will I receive?

Three types: completed when a task finishes, needs_input when the agent is blocked and waiting for you, and failed when an unrecoverable error stops the agent.

Manual setup

MCP client config

If you prefer to configure by hand, add nockit to your MCP client's config file:

{
  "mcpServers": {
    "nockit": {
      "command": "npx",
      "args": ["-y", "nockit-mcp"],
      "env": {
        "NTFY_TOPIC": "your_chosen_topic"
      }
    }
  }
}

Works with Claude Desktop, Cursor, Zed, and any client that supports MCP servers.