Back to the catalog

google-workspace-developer-tools

Google Workspace Developer Tools

Open source Open in the app JSON README (API)

About

Google Workspace Developer Tools

Details

Kind
Plugins
Topic
Productivity
Publisher
googleworkspace
Origin
gemini
Category
ferramentas
Version
latest
Stars
242
Forks
61
Open pull requests
4
Last push
2026-06-01T23:39:35Z
Repository state
ativo
Language
TypeScript
License
Apache-2.0
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
googleworkspace/developer-tools

README

# Google Workspace Developer Tools

[![Build Status](https://github.com/googleworkspace/developer-tools/actions/workflows/test.yml/badge.svg)](https://github.com/googleworkspace/developer-tools/actions/workflows/test.yml)
[![Release Status](https://github.com/googleworkspace/developer-tools/actions/workflows/release.yml/badge.svg)](https://github.com/googleworkspace/developer-tools/actions/workflows/release.yml)
[![Apache 2.0 License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

A collection of developer tools to enhance your Google Workspace development experience. This monorepo contains extensions, utilities, and resources designed to streamline development workflows for Google Workspace APIs and integrations.

## ๐Ÿš€ Quick Start

### VS Code Extension

Get intelligent OAuth2 scope linting and enhanced development tools directly in your editor:

**Install from Visual Studio Code:**

1. Open the Extensions view (`Ctrl+Shift+X` or `Cmd+Shift+X`)
2. Search for "Google Workspace Developer Tools"
3. Click Install

**Or install via command line:**

```sh
code --install-extension google-workspace.google-workspace-developer-tools
```

**Marketplaces:**

- [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=google-workspace.google-workspace-developer-tools)
- [Open VSX Registry](https://open-vsx.org/extension/google-workspace/google-workspace-developer-tools)

[Learn more โ†’](./packages/vscode-extension)

### Gemini CLI Extension

If you have the `gemini` command-line tool installed:

```sh
gemini extensions install \
  "https://github.com/googleworkspace/developer-tools"
```

![Extension Demo](https://raw.githubusercontent.com/googleworkspace/developer-tools/refs/heads/main/docs/gemini.gif)

## ๐Ÿ“ฆ Packages

### VS Code Extension (`packages/vscode-extension`)

A comprehensive VS Code extension providing:

- **OAuth2 Scope Linting**: Automatic warnings and suggestions for Google Workspace OAuth2 scopes in your code
  - Validates scope URLs against the official Google API registry
  - Highlights restricted and sensitive scopes
  - Provides hover documentation with scope descriptions and API associations
- **MCP (Model Context Protocol) Server**: Integrated support for enhanced AI-powered development tools

[Learn more โ†’](./packages/vscode-extension)

## ๐Ÿ› ๏ธ Development

This is a monorepo managed with [pnpm](https://pnpm.io/) and [Turbo](https://turbo.build/).

### Prerequisites

- Node.js (v18 or later recommended)
- pnpm (`npm install -g pnpm`)

### Setup

```sh
# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

# Lint and format code
pnpm lint

# Watch mode for development
pnpm --filter google-workspace-developer-tools dev
```

### Project Structure

```
โ”œโ”€โ”€ packages/
โ”‚   โ””โ”€โ”€ vscode-extension/     # VS Code extension
โ”œโ”€โ”€ turbo.json                # Turbo build configuration
โ””โ”€โ”€ pnpm-workspace.yaml       # pnpm workspace configuration
```

## ๐Ÿค Contributing

We welcome contributions! Whether it's bug reports, feature requests, or code contributions, please check out our [contributing guidelines](CONTRIBUTING.md) to get started.

### Ways to Contribute

- ๐Ÿ› Report bugs and issues
- ๐Ÿ’ก Suggest new features or improvements
- ๐Ÿ“ Improve documentation
- ๐Ÿ”ง Submit pull requests

## ๐Ÿ’ฌ Support

If you have questions or encounter issues:

- ๐Ÿ“‹ [File an issue](https://github.com/googleworkspace/developer-tools/issues) on GitHub
- ๐Ÿ’ก Check existing issues for solutions
- ๐Ÿ“š Review the documentation in each package

## ๐Ÿ“„ License

This project is licensed under the Apache 2.0 License. See the [LICENSE](LICENSE) file for details.

---

Made with โค๏ธ for the Google Workspace developer community

More