hyday

@mukiwu/hyday-channel

Claude Code channel server for Hyday — bridges note and journal events to Claude Code sessions.

What it does

When you read a note or journal entry in Hyday for more than 30 seconds, or send a message through the buddy chat bubble, this channel server pushes the event to your Claude Code session. Claude can then:

• Offer insights about the note you're reading
• Find related past entries across your journals
• Answer questions about your notes directly from the Hyday app
• Generate summaries and surface forgotten connections

Claude responds via the buddy chat bubble in Hyday's bottom-right corner.

Quick Start

1. Install in your Hyday notes directory

cd <your Hyday notes directory>
npm install @mukiwu/hyday-channel

2. Create .mcp.json in your notes directory

{
  "mcpServers": {
    "hyday": {
      "command": "npx",
      "args": ["hyday-channel"]
    }
  }
}

3. Start Claude Code

cd <your Hyday notes directory>
claude --dangerously-load-development-channels server:hyday --permission-mode bypassPermissions

On first run, the server automatically generates a CLAUDE.md file describing your notes directory structure, so Claude doesn't need to explore on every session.

Configuration

Environment Variable	Default	Description
HYDAY_CHANNEL_PORT	8789	HTTP port the channel server listens on

Event Types

Event	Trigger	Content
note_reading	User reads a note for 30+ seconds	Preview of note text
journal_reading	User reads a journal entry for 30+ seconds	Preview of journal text
user_message	User sends a message via buddy chat bubble	The message text

Each event includes: event_type, title, tags, file_id, and a text preview (first 500 chars).

Architecture

Hyday App  →  HTTP POST localhost:8789/event  →  hyday-channel (stdio)  →  Claude Code
Claude Code  →  reply tool  →  hyday-channel  →  SSE localhost:8789/events  →  Hyday buddy bubble

The channel server runs locally as a subprocess of Claude Code. It provides:

• POST /event — receives events from Hyday app
• GET /events — SSE stream for Claude's replies back to Hyday
• GET /health — status check
• reply MCP tool — Claude uses this to send messages visible in the buddy bubble

Endpoints

Method	Path	Description
GET	/health	Returns {"status":"ok","server":"hyday","version":"..."}
POST	/event	Receives JSON events from Hyday app
GET	/events	SSE stream of Claude's replies
OPTIONS	*	CORS preflight

Requirements

• Claude Code v2.1.80 or later
• Bun or Node.js 18+
• Hyday desktop app

License

MIT