@togglhq/mcp 1.5.26 → 1.5.28
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/build/cli.js +1 -1
- package/build/index.js +1 -1
- package/build/{src-iRB3kkYR.js → src-BhSinfRS.js} +8248 -8987
- package/package.json +5 -3
- package/skills/toggl-mcp/SKILL.md +1 -1
- package/skills/toggl-mcp/INTERNAL.md +0 -76
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@togglhq/mcp",
|
|
3
|
-
"version": "1.5.
|
|
3
|
+
"version": "1.5.28",
|
|
4
4
|
"description": "Toggl 2.0 MCP server for Claude Code, Claude Desktop, and other MCP clients.",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"type": "module",
|
|
@@ -11,7 +11,9 @@
|
|
|
11
11
|
"files": [
|
|
12
12
|
"build/**/*.js",
|
|
13
13
|
"build/**/*.d.ts",
|
|
14
|
-
"skills
|
|
14
|
+
"skills/*/SKILL.md",
|
|
15
|
+
"skills/*/reference/**",
|
|
16
|
+
"skills/*/workflows/**",
|
|
15
17
|
"README.md",
|
|
16
18
|
"LICENSE"
|
|
17
19
|
],
|
|
@@ -55,7 +57,7 @@
|
|
|
55
57
|
"@toggl/operations": "workspace:^",
|
|
56
58
|
"@types/node": "22.19.11",
|
|
57
59
|
"tsdown": "0.21.8",
|
|
58
|
-
"vitest": "3.2.
|
|
60
|
+
"vitest": "3.2.7"
|
|
59
61
|
},
|
|
60
62
|
"mcpName": "io.github.toggl/toggl-mcp"
|
|
61
63
|
}
|
|
@@ -25,7 +25,7 @@ The MCP server exposes **entity tools** (one tool per domain, for example `tasks
|
|
|
25
25
|
|
|
26
26
|
- **Entity domains**: tool names match `@toggl/operations` `mcp.entityTool` strings (examples: **`tasks`**, **`projects`**, **`saved-views`**, **`custom-fields`**, **`organization`**, **`org-invitations`**, **`shared-working-hours`**). Each tool accepts **`action`** values surfaced in server instructions and tool descriptions (hyphenated multi-word actions such as `bulk-patch`, `attachments-list`). Curated routing may group endpoints under the most helpful domain (for example composite flows and attachments under **`projects`** / **`tasks`**).
|
|
27
27
|
- **Workspace/auth**: **workspace-list** (optional `refresh`), **workspace-switch**, **profile-list**, **profile-switch**, **profile-remove**, **auth**, **logout**.
|
|
28
|
-
-
|
|
28
|
+
- Some low-level endpoints are omitted from the public tool surface.
|
|
29
29
|
|
|
30
30
|
## Install
|
|
31
31
|
|
|
@@ -1,76 +0,0 @@
|
|
|
1
|
-
# Internal Toggl MCP Workflows
|
|
2
|
-
|
|
3
|
-
Install `@toggl/mcp-internal` from **GitHub Packages** for internal builds that include staging, MS environments, and telemetry (`toggl-mcp-internal` / `mcp-internal` bins).
|
|
4
|
-
|
|
5
|
-
Configure `~/.npmrc` with a GitHub Packages token (`read:packages`) and Toggl org access:
|
|
6
|
-
|
|
7
|
-
```
|
|
8
|
-
@toggl:registry=https://npm.pkg.github.com/
|
|
9
|
-
//npm.pkg.github.com/:_authToken=<GH_NPM_TOKEN>
|
|
10
|
-
```
|
|
11
|
-
|
|
12
|
-
```bash
|
|
13
|
-
npm install @toggl/mcp-internal
|
|
14
|
-
# or: pnpm add @toggl/mcp-internal
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
## Environments
|
|
18
|
-
|
|
19
|
-
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.
|
|
20
|
-
|
|
21
|
-
Run against staging:
|
|
22
|
-
|
|
23
|
-
```bash
|
|
24
|
-
ENV=staging toggl-mcp-internal
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
Run against a named MS environment:
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
MS=<name> toggl-mcp-internal
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
Explicit URL overrides still take precedence:
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
TOGGL_FOCUS_API_URL=<url> TOGGL_ACCOUNTS_API_URL=<url> toggl-mcp-internal
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
## Telemetry
|
|
40
|
-
|
|
41
|
-
The GitHub internal build enables Sentry tracing by default with the internal DSN. Tool inputs and outputs are not recorded unless `SENTRY_RECORD_TOOL_IO=true`.
|
|
42
|
-
|
|
43
|
-
Disable telemetry:
|
|
44
|
-
|
|
45
|
-
```bash
|
|
46
|
-
SENTRY_DSN=off toggl-mcp-internal
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
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.
|
|
50
|
-
|
|
51
|
-
## Maintainer: from source
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
git clone <private-repo-url>
|
|
55
|
-
cd toggl-mcp
|
|
56
|
-
pnpm install
|
|
57
|
-
pnpm run build
|
|
58
|
-
node packages/mcp/build/cli.js auth
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
## Maintainer: GitHub Release `.mcpb` bundles
|
|
62
|
-
|
|
63
|
-
Internal releases attach per-platform binary bundles (no Node on `PATH`):
|
|
64
|
-
|
|
65
|
-
- `toggl-focus-mcp-<version>-darwin-arm64.mcpb` (+ `.sha256`)
|
|
66
|
-
- `toggl-focus-mcp-<version>-darwin-x64.mcpb` (+ `.sha256`)
|
|
67
|
-
- `toggl-focus-mcp-<version>-linux-x64.mcpb` (+ `.sha256`)
|
|
68
|
-
- `toggl-focus-mcp-<version>-win32-x64.mcpb` (+ `.sha256`)
|
|
69
|
-
|
|
70
|
-
Download from the `@togglhq/mcp@<version>` GitHub release tag and open in a compatible MCP client.
|
|
71
|
-
|
|
72
|
-
Node-based MCPB for debugging: `pnpm --filter @toggl/mcp run build:mcpb:node`.
|
|
73
|
-
|
|
74
|
-
## Maintainer: publishing
|
|
75
|
-
|
|
76
|
-
Public npm: `@togglhq/mcp` via Trusted Publishing. Internal: `@toggl/mcp-internal` on GitHub Packages. See repo `docs/public-publishing.md` and `AGENTS.md`.
|