@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. Create .mcp.json in your Hyday notes directory

{
  "mcpServers": {
    "hyday": {
      "command": "npx",
      "args": ["@mukiwu/hyday-channel@latest"]
    }
  }
}

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