@togglhq/mcp 1.5.20 → 1.5.22

package/README.md

@@ -1,6 +1,20 @@
-# Toggl Focus MCP Server
+# Toggl 2.0 MCP Server
 
-A local MCP (Model Context Protocol) server that connects to the Toggl Focus API. Works with any MCP client including Claude Code and Claude Desktop.
+A local MCP (Model Context Protocol) server that connects to the Toggl 2.0 API. Works with any MCP client including Claude Code and Claude Desktop.
+
+## One-click install
+
+[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=toggl&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40togglhq%2Fmcp%22%5D%2C%22env%22%3A%7B%7D%7D)
+[![Install in VS Code Insiders](https://img.shields.io/badge/Install_in-VS_Code_Insiders-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=toggl&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40togglhq%2Fmcp%22%5D%2C%22env%22%3A%7B%7D%7D&quality=insiders)
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=toggl&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0b2dnbGhxL21jcCJdfQ==)
+
+Cursor install link (copy or open in Cursor):
+
+```
+cursor://anysphere.cursor-deeplink/mcp/install?name=toggl&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0b2dnbGhxL21jcCJdfQ==
+```
+
+After install, run `npx @togglhq/mcp auth` once to sign in. For Claude Code and Claude Desktop, see **Add to your MCP client** below.
 
 ## Install
 
@@ -87,38 +101,6 @@ One tool per domain (for example `tasks`, `projects`, `time-blocks`, `time-entri
 
 Agent-oriented guidance ships in `skills/toggl-mcp/SKILL.md` inside this package.
 
-## MCP Apps (inline UI)
-
-Cursor **2.6+**, Claude Desktop, and other MCP App hosts can render **view tools** inline in chat.
-
-- **Resource**: `ui://toggl-focus/app.html`
-- **When to use**: Prefer view tools when the user asks to **show**, **see**, or **visualize** Focus data. Use entity tools for mutations and non-UI hosts.
-
-| Tool                           | Use when                     |
-| ------------------------------ | ---------------------------- |
-| `focus-tasks-inbox`            | Task list / backlog          |
-| `focus-task-detail`            | Single task deep-dive        |
-| `focus-status-board`           | Kanban-style status snapshot |
-| `focus-projects-overview`      | Project list                 |
-| `focus-project-detail`         | Single project overview      |
-| `focus-milestones-roadmap`     | Milestones by due date       |
-| `focus-search-results`         | Search across entities       |
-| `focus-week-at-a-glance`       | Week plan vs tracked time    |
-| `focus-day-today`              | Today's schedule             |
-| `focus-time-log`               | Time entries table           |
-| `focus-time-blocks`            | Scheduled blocks             |
-| `focus-report-workload`        | Team workload / utilization  |
-| `focus-report-time-by-project` | Time grouped by project      |
-| `focus-report-time-by-member`  | Time grouped by member       |
-| `focus-report-billable`        | Billable summary             |
-| `focus-report-task-throughput` | Task completion throughput   |
-| `focus-team-roster`            | Workspace members            |
-| `focus-clients-directory`      | Client list                  |
-| `focus-time-off-calendar`      | Time off in range            |
-| `focus-holidays-calendar`      | Public holidays              |
-| `focus-mutation-review`        | Confirm pending mutation     |
-| `focus-dry-run-preview`        | Preview dry-run payload      |
-
 ## License
 
 Proprietary Toggl software. See [LICENSE](LICENSE) and [Toggl legal terms](https://toggl.com/legal/).

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(", ")}`);
@@ -32399,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"),
@@ -44034,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",
@@ -44820,10 +44820,10 @@ 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.
+	return `Toggl 2.0 MCP is not authenticated.
 Call the auth tool to authenticate (or run ${npxMcpAuthCommand()} manually).
 
 ${core}`;
@@ -45798,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,
@@ -45953,7 +45953,7 @@ import_main.default.config({
 	quiet: true,
 	ignore: ["MISSING_ENV_FILE"]
 });
-const packageVersion = "1.5.20";
+const packageVersion = "1.5.22";
 function resolvePublicUrls() {
 	return {
 		focusApiUrl: process.env.TOGGL_FOCUS_API_URL ?? "https://focus.toggl.com",
@@ -45990,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({
@@ -46007,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,7 +1,7 @@
 {
   "name": "@togglhq/mcp",
-  "version": "1.5.20",
-  "description": "Toggl Focus MCP server for Claude Code, Claude Desktop, and other MCP clients.",
+  "version": "1.5.22",
+  "description": "Toggl 2.0 MCP server for Claude Code, Claude Desktop, and other MCP clients.",
   "license": "UNLICENSED",
   "type": "module",
   "publishConfig": {
@@ -56,5 +56,6 @@
     "@types/node": "22.19.11",
     "tsdown": "0.21.8",
     "vitest": "3.2.4"
-  }
+  },
+  "mcpName": "io.github.toggl/toggl-mcp"
 }

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.).