Polar — Agent Plugins package

Portable Agent Plugins v1 package for Hermes Agent and other Agent Plugins clients: the polar MCP server (polar-mcp-unofficial@0.6.0 over stdio) plus the polar-mcp workflow skill.

Install (Hermes Agent)

hermes plugins install davidmosiah/polar-mcp/agent-plugin --no-enable
hermes plugins enable polar-mcp

Requires Node.js 20+ (npx on PATH). The skill loads as polar-mcp:polar-mcp.

Connector setup

npx -y polar-mcp-unofficial@0.6.0 setup --client generic
npx -y polar-mcp-unofficial@0.6.0 auth
npx -y polar-mcp-unofficial@0.6.0 doctor

setup asks for the Polar developer app client ID and secret and saves them locally (--client generic because this plugin already registers the server with Hermes); auth opens the Polar consent page in the browser and stores the OAuth tokens under ~/.polar-mcp/ with 0600 permissions; doctor confirms readiness.

Disclosure

Runs the polar-mcp-unofficial@0.6.0 npm package locally over stdio through npx (Node.js 20+ required); the package is downloaded from npm on first start. Data source: the official Polar AccessLink Dynamic API v4. Credentials and OAuth tokens are created by the connector's own setup/auth commands in the user's terminal and stay on the machine (~/.polar-mcp/); the plugin declares no environment variables and reads no Hermes credentials. Tools that change state: polar_profile_update (local profile only); polar_exchange_code (stores OAuth tokens locally); polar_revoke_access (deletes local tokens only; the user must revoke the remote grant in Polar AccessLink/Flow if needed). The tool set comes from the pinned npm version, not from this repository's source tree.

Upgrading an existing client

Review the migration guide before upgrading. Authenticated response caching and offline cache fallback are disabled; upgrading does not erase historical cache files. Profiles reject invalid values, files over 256 KiB and symlinks. Tool inputs are limited to 10,000 elements. The stdio launcher, Node.js 20+ requirement and user-run authorization flow are unchanged. Restart the client and check the reported version, doctor output and synthetic demo before using an account.

${PLUGIN_DATA} sets the working directory, not an account boundary. Provider configuration and tokens still use the user home; the wellness profile is shared at ~/.delx-wellness/profile.json. Keep separate identities in separate operating-system homes. This plugin update does not authorize an account or migrate credentials.

polar_list_continuous_samples and polar_list_ppi_samples now bound complete records with max_points (default 2000, maximum 5000). Inspect truncated and omitted_records: oversized records may be omitted rather than partially sliced.