Skip to main content
Glama
Sign In
glanceway-mcp

glanceway-mcp

Official
by glanceway
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Glanceway MCP Server

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

Related MCP server: mcp-server-chatgpt-app

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.

Available Tools

3 tools
glanceway_list_favoritesA

List favorited items from Glanceway. Returns items sorted by favorited time (newest first).

Inputs: limit, since, until.

glanceway_list_itemsB

List items from Glanceway sources. Returns items sorted by timestamp (newest first).

Inputs: limit, since, until, isRead, +1 more.

glanceway_list_sourcesA

List all enabled sources configured in Glanceway

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.6/5.0

    Scored across 3 tools

    Disambiguation4/5

    The three tools are mostly distinct: sources are configuration entities, items are the feed contents, and favorites are a subset of items with dedicated favorited-time sorting. Some ambiguity remains because favorites are also items, but the descriptions clarify the intended distinction.

    Naming Consistency5/5

    All tool names follow the same consistent pattern: glanceway_list_<resource>. The verb is always 'list', resources are clear singular nouns, and casing is uniformly snake_case with a consistent prefix.

    Tool Count4/5

    Three tools is a reasonable, focused set for a read-only listing server. It is slightly minimal, but each tool covers a distinct resource and there is no obvious redundancy or bloat.

    Completeness2/5

    The tool set is entirely focused on list operations and lacks any detail retrieval, searching, filtering, or actions such as favoriting/unfavoriting items. While listing sources/items/favorites is coherent, the surface has significant gaps for a real Glanceway workflow.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers