Glanceway

MCP (Model Context Protocol) server for Glanceway, the macOS menu bar information app. Lets AI assistants read your sources and items.

Install

mcpb (recommended)

Download glanceway.mcpb from the latest release and open it in Claude Desktop to install.

Build from source

npm install
npm run build    # bundle to dist/mcpb/server/index.mjs
npm run pack     # build + produce dist/glanceway.mcpb

Add to Claude Desktop manually

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "glanceway": {
      "command": "node",
      "args": ["/path/to/dist/mcpb/server/index.mjs"]
    }
  }
}

Add to Claude Code

claude mcp add glanceway -- npx -y glanceway-mcp

Tools

Tool	Description
glanceway_list_sources	List all enabled sources
glanceway_list_items	List items, optionally filtered by sourceId or isRead

Prompts

Prompt	Description
summarize	Fetch all items and produce a grouped digest

How it works

The server discovers the running Glanceway app by scanning localhost ports 9470-9479 for the local API. Glanceway must be running for the tools to work.