@togglhq/mcp 1.5.19 → 1.5.20

package/build/index.js

@@ -32282,6 +32282,13 @@ async function resolveAuthenticatedWorkspace(workspaces, options) {
 	}
 	throw new WorkspaceSelectionRequiredError$1(workspaces);
 }
+const PUBLIC_CLI_PACKAGE_NAME = "@togglhq/cli";
+const PUBLIC_MCP_PACKAGE_NAME = "@togglhq/mcp";
+`${PUBLIC_CLI_PACKAGE_NAME}`;
+`${PUBLIC_MCP_PACKAGE_NAME}`;
+function npxMcpAuthCommand() {
+	return `npx ${PUBLIC_MCP_PACKAGE_NAME} auth`;
+}
 async function refreshTokens(accountsApiUrl, refreshToken) {
 	const params = new URLSearchParams({
 		grant_type: "refresh_token",
@@ -32297,7 +32304,7 @@ async function refreshTokens(accountsApiUrl, refreshToken) {
 }
 async function getValidToken$1(scope = "cli", profile) {
 	const authConfig = loadProfile(scope, profile);
-	if (!authConfig) throw new Error(scope === "cli" ? "Not authenticated. Run `toggl auth` to sign in." : "Not authenticated. Run `npx @toggl/mcp auth` to sign in.");
+	if (!authConfig) throw new Error(scope === "cli" ? "Not authenticated. Run `toggl auth` to sign in." : `Not authenticated. Run \`${npxMcpAuthCommand()}\` to sign in.`);
 	const now = Date.now() / 1e3;
 	if (authConfig.expires_at > now + 60) return authConfig.access_token;
 	const tokens = await refreshTokens(authConfig.accounts_api_url, authConfig.refresh_token);
@@ -32313,11 +32320,11 @@ async function getValidToken$1(scope = "cli", profile) {
 	return authConfig.access_token;
 }
 function requireMcpDeveloperProfile(profile) {
-	if (!loadProfile("mcp", profile)) throw new Error("Not authenticated. Call the auth tool or run `npx @toggl/mcp auth`.");
+	if (!loadProfile("mcp", profile)) throw new Error(`Not authenticated. Call the auth tool or run \`${npxMcpAuthCommand()}\`.`);
 	const dev = loadDeveloperToolsConfig();
-	if (!dev?.profiles) throw new Error("Not authenticated. Call the auth tool or run `npx @toggl/mcp auth`.");
+	if (!dev?.profiles) throw new Error(`Not authenticated. Call the auth tool or run \`${npxMcpAuthCommand()}\`.`);
 	const profileKey = profile ?? dev.active.mcp;
-	if (!profileKey || !dev.profiles[profileKey]) throw new Error("Not authenticated. Call the auth tool or run `npx @toggl/mcp auth`.");
+	if (!profileKey || !dev.profiles[profileKey]) throw new Error(`Not authenticated. Call the auth tool or run \`${npxMcpAuthCommand()}\`.`);
 	return {
 		profileKey,
 		auth: dev.profiles[profileKey]
@@ -32459,7 +32466,7 @@ async function runAuthFlow(accountsApiUrl = "https://accounts.toggl.com", focusA
 const AUTH_ERROR = {
 	ok: false,
 	status: 401,
-	message: "Not authenticated. Call the auth tool first (or run `npx @toggl/mcp auth` manually)."
+	message: `Not authenticated. Call the auth tool first (or run \`${npxMcpAuthCommand()}\` manually).`
 };
 const FOCUS_CLIENT_SYNC_PASSTHROUGH_PROP_KEYS = [
 	"httpClient",
@@ -44817,7 +44824,7 @@ Entity mutations and \`profile-remove\` issue a \`confirm_token\` on the first c
 
 ${core}`;
 	return `Toggl Focus MCP is not authenticated.
-Call the auth tool to authenticate (or run npx @toggl/mcp auth manually).
+Call the auth tool to authenticate (or run ${npxMcpAuthCommand()} manually).
 
 ${core}`;
 }
@@ -45641,7 +45648,7 @@ function registerWorkspaceTools(server) {
 		if (!config) return {
 			content: [{
 				type: "text",
-				text: "Not authenticated. Call auth (or run `npx @toggl/mcp auth`)."
+				text: `Not authenticated. Call auth (or run \`${npxMcpAuthCommand()}\`).`
 			}],
 			isError: true
 		};
@@ -45677,7 +45684,7 @@ function registerWorkspaceTools(server) {
 		if (!config) return {
 			content: [{
 				type: "text",
-				text: "Not authenticated. Call auth (or run `npx @toggl/mcp auth`)."
+				text: `Not authenticated. Call auth (or run \`${npxMcpAuthCommand()}\`).`
 			}],
 			isError: true
 		};
@@ -45946,7 +45953,7 @@ import_main.default.config({
 	quiet: true,
 	ignore: ["MISSING_ENV_FILE"]
 });
-const packageVersion = "1.5.19";
+const packageVersion = "1.5.20";
 function resolvePublicUrls() {
 	return {
 		focusApiUrl: process.env.TOGGL_FOCUS_API_URL ?? "https://focus.toggl.com",

package/package.json

@@ -1,12 +1,8 @@
 {
   "name": "@togglhq/mcp",
-  "version": "1.5.19",
-  "description": "Toggl Focus MCP server — @toggl/mcp on npm, @toggl/mcp-internal on GitHub Packages",
+  "version": "1.5.20",
+  "description": "Toggl Focus MCP server for Claude Code, Claude Desktop, and other MCP clients.",
   "license": "UNLICENSED",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/toggl/toggl-mcp.git"
-  },
   "type": "module",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -16,7 +12,8 @@
     "build/**/*.js",
     "build/**/*.d.ts",
     "skills/**",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "bin": {
     "mcp": "./build/index.js",

package/skills/toggl-mcp/INTERNAL.md

@@ -2,6 +2,18 @@
 
 Install `@toggl/mcp-internal` from **GitHub Packages** for internal builds that include staging, MS environments, and telemetry (`toggl-mcp-internal` / `mcp-internal` bins).
 
+Configure `~/.npmrc` with a GitHub Packages token (`read:packages`) and Toggl org access:
+
+```
+@toggl:registry=https://npm.pkg.github.com/
+//npm.pkg.github.com/:_authToken=<GH_NPM_TOKEN>
+```
+
+```bash
+npm install @toggl/mcp-internal
+# or: pnpm add @toggl/mcp-internal
+```
+
 ## Environments
 
 Use the public npm build by default. Use the GitHub internal build only when a Toggl engineer asks for staging or a named MS environment.
@@ -35,3 +47,30 @@ SENTRY_DSN=off toggl-mcp-internal
 ```
 
 Burst detection is enabled when telemetry is enabled. It attaches retry metadata to Sentry spans and logs warnings when an MCP client repeats the same tool rapidly.
+
+## Maintainer: from source
+
+```bash
+git clone <private-repo-url>
+cd toggl-mcp
+pnpm install
+pnpm run build
+node packages/mcp/build/index.js auth
+```
+
+## Maintainer: GitHub Release `.mcpb` bundles
+
+Internal releases attach per-platform binary bundles (no Node on `PATH`):
+
+- `toggl-focus-mcp-<version>-darwin-arm64.mcpb` (+ `.sha256`)
+- `toggl-focus-mcp-<version>-darwin-x64.mcpb` (+ `.sha256`)
+- `toggl-focus-mcp-<version>-linux-x64.mcpb` (+ `.sha256`)
+- `toggl-focus-mcp-<version>-win32-x64.mcpb` (+ `.sha256`)
+
+Download from the `@togglhq/mcp@<version>` GitHub release tag and open in a compatible MCP client.
+
+Node-based MCPB for debugging: `pnpm --filter @toggl/mcp run build:mcpb:node`.
+
+## Maintainer: publishing
+
+Public npm: `@togglhq/mcp` via Trusted Publishing. Internal: `@toggl/mcp-internal` on GitHub Packages. See repo `docs/public-publishing.md` and `AGENTS.md`.

package/skills/toggl-mcp/SKILL.md

@@ -27,11 +27,16 @@ The MCP server exposes **entity tools** (one tool per domain, for example `tasks
 - **Workspace/auth**: **workspace-list** (optional `refresh`), **workspace-switch**, **profile-list**, **profile-switch**, **profile-remove**, **auth**, **logout**.
 - Catalog entries marked hidden (e.g. calendar integrations, scheduler helpers, utilization targets) are omitted—parity with `visibleOperations()` in the CLI.
 
-## Installing from GitHub (`.mcpb`)
+## Install
 
-Releases ship **per-platform** binary bundles (no Node on `PATH`): pick `darwin-arm64`, `darwin-x64`, `linux-x64`, or `win32-x64` from the `@toggl/mcp@<version>` release assets—see [packages/mcp/README.md](https://github.com/toggl/toggl-mcp/blob/main/packages/mcp/README.md).
+```bash
+npm install @togglhq/mcp
+npx @togglhq/mcp auth
+```
+
+Pair with the `toggl-cli` skill for terminal equivalents (`toggl --json`, `--dry-run`, etc.).
 
 ## Read next
 
-- Repository reference: [packages/mcp/README.md](https://github.com/toggl/toggl-mcp/blob/main/packages/mcp/README.md)
-- Terminal parity: `toggl-cli` skill (`packages/cli/skills/toggl-cli/SKILL.md` in this repo)
+- Bundled package README (in your `node_modules/@togglhq/mcp` install)
+- `toggl-cli` skill for CLI parity