@togglhq/mcp 1.5.19 → 1.5.21

package/build/index.js

@@ -32260,7 +32260,7 @@ async function fetchAccessibleWorkspaces(accountsApiUrl, token) {
 	}));
 }
 async function resolveAuthenticatedWorkspace(workspaces, options) {
-	if (workspaces.length === 0) throw new Error("No Focus workspaces found for this account.");
+	if (workspaces.length === 0) throw new Error("No Toggl 2.0 workspaces found for this account.");
 	if (options.explicitWorkspaceId !== void 0) {
 		const match = workspaces.find((w) => w.workspace_id === options.explicitWorkspaceId);
 		if (!match) throw new Error(`Workspace ${options.explicitWorkspaceId} not found. Available: ${workspaces.map((w) => `${w.workspace_id} (${w.workspace_name})`).join(", ")}`);
@@ -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]
@@ -32392,7 +32399,7 @@ async function runAuthFlow(accountsApiUrl = "https://accounts.toggl.com", focusA
 		focusApiUrl = pendingContext.focus_api_url;
 		log("Continuing MCP authentication with existing session...\n");
 	} else {
-		log("Toggl Focus MCP — Authentication\n");
+		log("Toggl 2.0 MCP — Authentication\n");
 		const { code, verifier, redirectUri } = await obtainTogglOAuthAuthorizationCode({
 			accountsApiUrl,
 			flowMode: options.oauthFlowMode ?? (options.manualPrompt ? "manual" : "local"),
@@ -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",
@@ -44027,7 +44034,7 @@ const schedulerOverrides = {
 	"focus.scheduler.validate-instructions": { hidden: true }
 };
 const searchOverrides = { "focus.search.search": {
-	description: "Search across Focus entities.",
+	description: "Search across Toggl 2.0 entities.",
 	cli: {
 		group: [],
 		command: "search",
@@ -44813,11 +44820,11 @@ Entity mutations and \`profile-remove\` issue a \`confirm_token\` on the first c
 - Task priority levels when setting priority: \`none\`, \`low\`, \`medium\`, \`high\`.
 - Time blocks are planned calendar time; time entries are tracked time.
 `;
-	if (options.authenticated) return `You are connected to the Toggl Focus workspace ${options.workspaceLabel ?? "your workspace"}.
+	if (options.authenticated) return `You are connected to the Toggl 2.0 workspace ${options.workspaceLabel ?? "your workspace"}.
 
 ${core}`;
-	return `Toggl Focus MCP is not authenticated.
-Call the auth tool to authenticate (or run npx @toggl/mcp auth manually).
+	return `Toggl 2.0 MCP is not authenticated.
+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
 		};
@@ -45791,7 +45798,7 @@ function registerWorkspaceTools(server) {
 	});
 	server.registerTool("auth", {
 		title: "Authenticate MCP",
-		description: "Authenticate this MCP server with Toggl Focus via OAuth. Opens browser login and stores credentials locally. Optionally pass workspace_id to pick a specific workspace when multiple are available.",
+		description: "Authenticate this MCP server with Toggl 2.0 via OAuth. Opens browser login and stores credentials locally. Optionally pass workspace_id to pick a specific workspace when multiple are available.",
 		annotations: {
 			readOnlyHint: false,
 			destructiveHint: false,
@@ -45946,7 +45953,7 @@ import_main.default.config({
 	quiet: true,
 	ignore: ["MISSING_ENV_FILE"]
 });
-const packageVersion = "1.5.19";
+const packageVersion = "1.5.21";
 function resolvePublicUrls() {
 	return {
 		focusApiUrl: process.env.TOGGL_FOCUS_API_URL ?? "https://focus.toggl.com",
@@ -45983,7 +45990,7 @@ function bootstrapServer(options = {}) {
 	applyResolvedUrls(urls);
 	const config = loadConfig();
 	const authenticated = Boolean(config);
-	console.error(`Using Focus API: ${urls.focusApiUrl}`);
+	console.error(`Using Toggl 2.0 API: ${urls.focusApiUrl}`);
 	const client = createAuthenticatedClientProxy();
 	const workspaceLabel = config ? `${config.workspace_name ?? "Workspace"} (ID: ${config.workspace_id})` : void 0;
 	const rawServer = new McpServer({
@@ -46000,7 +46007,7 @@ function bootstrapServer(options = {}) {
 		const transport = new StdioServerTransport();
 		options.beforeConnect?.();
 		await server.connect(transport);
-		console.error(config ? `Toggl Focus MCP server running on stdio (workspace: ${workspaceLabel})` : "Toggl Focus MCP server running on stdio (not authenticated)");
+		console.error(config ? `Toggl 2.0 MCP server running on stdio (workspace: ${workspaceLabel})` : "Toggl 2.0 MCP server running on stdio (not authenticated)");
 	}
 	main().catch((err) => {
 		console.error("Fatal error:", err);

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.21",
+  "description": "Toggl 2.0 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

@@ -1,9 +1,9 @@
 ---
 name: toggl-mcp
-description: Use the Toggl Focus MCP server to read and mutate Focus data (tasks, projects, time blocks, time entries, saved views, custom fields, attachments, organization and org-* domains, org-time-off-me, shared-status/holidays/working-hours tools), manage workspaces and saved profiles, authenticate, and mirror CLI-style workflows from an MCP client. Trigger when the user connects through Model Context Protocol tools rather than the terminal, or asks how to use toggl-focus MCP tools, confirm_token, dry_run, file uploads/downloads, workspace refresh, or profile switching.
+description: Use the Toggl 2.0 MCP server to read and mutate Toggl 2.0 data (tasks, projects, time blocks, time entries, saved views, custom fields, attachments, organization and org-* domains, org-time-off-me, shared-status/holidays/working-hours tools), manage workspaces and saved profiles, authenticate, and mirror CLI-style workflows from an MCP client. Trigger when the user connects through Model Context Protocol tools rather than the terminal, or asks how to use toggl-focus MCP tools, confirm_token, dry_run, file uploads/downloads, workspace refresh, or profile switching.
 ---
 
-# Toggl Focus MCP
+# Toggl 2.0 MCP
 
 The MCP server exposes **entity tools** (one tool per domain, for example `tasks`, `projects`) plus **workspace**, **profile**, and **auth** tools. Behavior aligns with the shared `@toggl/operations` catalog used by `toggl` CLI—see the `toggl-cli` skill for terminal equivalents (`toggl --json`, `--dry-run`, etc.).
 
@@ -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