Google Workspace Developer Tools
https://github.com/googleworkspace/developer-tools- Category
- Developer Tools
- Rank
- No. 922Tools index
- Pricing
- Open Source
- Type
- TOOL
- Builder
- googleworkspace
- GitHub
- 241 stars
- Latest release
- google-workspace-developer-tools@0.6.2
- Date
About
VS Code extension and tooling for building Google Workspace add-ons and Apps Script projects without leaving your editor.
What it does
It watches Google OAuth2 scope URLs as you type. The editor flags unknown, sensitive, and restricted scopes, completes known values, and shows descriptions plus associated APIs. It can also register a remote Workspace documentation service for compatible AI tooling.
Why it's ranked here
Its value is narrow but concrete: authorization mistakes become visible at the point of editing. Scope completion, risk classifications, explanatory hovers, and tested behavior make it useful. The remote documentation service adds another interface, though its implementation is not included here.
What's good
The scope data connects each permission to descriptions, API versions, and documentation links. Diagnostics distinguish invalid scopes from permissions requiring extra scrutiny. Completion inserts only the missing suffix. Special Apps Script permissions and current-document alternatives receive explicit treatment. Tests cover known and unknown descriptions plus completion behavior.
Tradeoffs
The editor analysis recognizes scope URLs through a restricted character pattern and processes files line by line. Risk classifications are maintained as explicit lists, so correctness depends on updates. The remote MCP service is registered by URL, but its server implementation is absent from the supplied repository text. Visible tests cover only descriptions and one completion case.
How to use it well
Use it when reviewing or writing code containing Google API permission URLs, especially before OAuth verification work. Keep it active for immediate warnings and completion, then use the registered documentation service for broader questions. Do not expect the shown code to scaffold, deploy, or manage an add-on project.
Technical notes+
packages/vscode-extension/src/extension.ts registers hover, completion, diagnostics, and an HTTP MCP definition targeting the endpoint declared in server.json. packages/vscode-extension/src/scopes.ts builds a scope map from packages/vscode-extension/src/apis.ts, adds Apps Script-specific entries, and applies explicit sensitive and restricted classifications. packages/vscode-extension/scripts/fetch-apis.ts fetches Google Discovery metadata and rewrites the API dataset. packages/vscode-extension/tsup.config.mjs bundles the extension and tests as CommonJS, while packages/vscode-extension/.vscode-test.mjs runs compiled tests against VS Code Insiders. Root orchestration uses pnpm and Turbo through package.json and turbo.json.
Observed
- License
- Apache License 2.0
- Primary language
- TypeScript
- Install surfaces
- Visual Studio Marketplace, Open VSX Registry, and Gemini CLI extension installation
- Interfaces
- VS Code extension and remote streamable HTTP MCP server
- Packaging
- Private pnpm monorepo managed with Turbo
- Testing structure
- Extension source includes separate scope-description and completion test suites
Read from README.md, package.json, packages/vscode-extension/tsup.config.mjs, packages/vscode-extension/.vscode-test.mjs, packages/vscode-extension/src/apis.ts, packages/vscode-extension/src/scopes.ts, packages/vscode-extension/src/extension.ts, packages/vscode-extension/scripts/fetch-apis.ts, packages/vscode-extension/src/test/scopes.test.ts, packages/vscode-extension/src/test/completion.test.ts, LICENSE, biome.json, turbo.json, server.json, SECURITY.md.
What it can do
Create Google Workspace add-ons
Developer code and configuration → Functional Google Workspace add-on
Build Apps Script projects
JavaScript code and project structure → Deployed Apps Script application
Debug Google Workspace code
Add-on or Apps Script code with issues → Identified errors and debugging information
Deploy add-ons to Google Workspace
Completed add-on project → Live add-on integrated with Google Workspace apps
Manage Apps Script project dependencies
Project requirements and library specifications → Configured project with required dependencies
Test Google Workspace integrations
Add-on or Apps Script code → Test results and integration validation
Tags
Tech Stack
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.