← Back to Skills Marketplace
byungkyu

google-forms

by byungkyu · GitHub ↗ · v1.2.5 · MIT-0
cross-platform ✓ Security Clean
6213
Downloads
5
Stars
0
Active Installs
14
Versions
Install in OpenClaw
/install google-forms
Description
Google Forms API integration with managed OAuth. Create forms, add questions, and retrieve responses. Use this skill when users want to interact with Google Forms. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a Google Forms connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a Google Forms action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with Google Forms examples; they add no Google Forms capability - Google Forms is not an event source, a trigger cannot read Google Forms data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe).
Usage Guidance
Install only if you intend to use Maton for Google Forms. Review OAuth scopes, prefer read-only access when possible, confirm every write or automation before it runs, and be especially careful with triggers or destinations because they can create ongoing data forwarding.
Capability Assessment
ℹ Credentials
The skill needs network access, a Maton account, OAuth authorization, and may access Google Forms data through the connected account; these are expected for its purpose and are disclosed.
ℹ Install Mechanism
Installation uses pinned Maton CLI/SDK package versions via npm, Homebrew, pip, or npm SDKs; this is proportionate for an API integration but users should trust the Maton tooling they install.
✓ Instruction Scope
Instructions repeatedly limit default behavior to read/list calls, require explicit approval for writes and connection creation, and treat unrelated endpoints, local execution, and third-party destinations as out of scope unless the user asks specifically.
ℹ Persistence & Privilege
OAuth tokens are stored in the OS credential store, and optional hosted functions/triggers/destinations can persist until deleted; the artifact discloses this and requires explicit user approval and cleanup guidance.
✓ Purpose & Capability
The stated purpose is Google Forms access through Maton; documented capabilities cover reading forms and responses, creating forms/questions, and optional user-approved automation around those actions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install google-forms
  3. After installation, invoke the skill by name or use /google-forms
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.5
Simplify the login instructions to the code flow (maton login prints a link; finish with maton login --code <CODE>), drop the API Key subsection, and pin the Maton CLI install to 0.4.0.
v1.2.4
Switch the login instructions to the device flow (maton login prints a link and a user code; the --oauth flag is gone) and pin the Maton CLI install to 0.3.5.
v1.2.3
Pin the Maton CLI install to 0.3.4, the current release.
v1.2.2
Add this skill's own trigger policy to the shared Triggers section: the only destination it sets up is its own hosted function inside the platform, it does not forward events to third-party hosts, and it does not use event watch --exec; each trigger reference now also says this skill configures no trigger from that source on its own.
v1.2.1
Bring the skill to the current api-gateway baseline and tell the connection-to-function-to-trigger story: the shared Functions and Triggers sections open with an example for this app (a hosted function that performs one action for it through the Maton SDK, and the trigger that runs it - its own event source where it has one, otherwise a time schedule), the description says these constructs turn the connection into automation and add no capability of their own, the passthrough is described by its enforced boundary, CLI and SDK installs are pinned to 0.3.1, absolute API URLs are placeholders, and multipart uploads use mktemp.
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.6
- Updated all endpoint and API URLs from gateway.maton.ai and ctrl.maton.ai to api.maton.ai for consistency. - Enhanced documentation on connection management and emphasized specifying the connection when multiple accounts are present. - Added a new "Security & Permissions" section clarifying that write operations require explicit user approval. - Removed the LICENSE.txt file.
v1.0.5
- Added a "clawdbot" metadata section with an emoji and required environment variable information to the skill manifest. - No other content or functional changes made in this version.
v1.0.4
- Minor updates to troubleshooting section for API key and app name issues. - No changes to code, features, or endpoints. - Documentation remains focused on setup, connection management, and API usage.
v1.0.3
- Bash-based curl examples replaced with Python one-liner scripts for all quick start and connection management operations. - Added a troubleshooting section explaining steps to resolve "Invalid API key" errors, including verifying your environment variable and testing with a Python snippet. - All previous functionality and API reference retained; code examples for JavaScript and Python remain unchanged.
v1.0.2
- Added note to use the api-gateway skill for other third party apps. - Updated curl and environment variable usage examples for consistency and shell compatibility. - Added important notes about using curl with brackets (-g flag) and handling environment variable expansion when piping output. - No functional or breaking API changes.
v1.0.1
- Updated documentation for more flexible base URL usage—supporting any native Google Forms API endpoint via `{native-api-path}`. - Expanded connection management instructions, now including how to specify connections using the `Maton-Connection` header. - Enhanced connection response example to show additional fields like `creation_time`, `last_updated_time`, and `metadata`. - Clarified authentication steps and copy instructions for obtaining an API key. - No API or functionality changes; documentation and usage improvements only.
v1.0.0
Initial release of Google Forms API integration. - Create, update, and retrieve Google Forms using a managed OAuth workflow. - Add various question types, including text, multiple choice, and scale questions, via batchUpdate requests. - Retrieve form responses and individual response details. - Includes detailed API reference, connection management guides, and code examples for JavaScript and Python. - Requires a Maton API key and active OAuth connection.
Metadata
Slug google-forms
Version 1.2.5
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 14
Frequently Asked Questions

What is google-forms?

Google Forms API integration with managed OAuth. Create forms, add questions, and retrieve responses. Use this skill when users want to interact with Google Forms. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a Google Forms connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a Google Forms action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with Google Forms examples; they add no Google Forms capability - Google Forms is not an event source, a trigger cannot read Google Forms data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe). It is an AI Agent Skill for Claude Code / OpenClaw, with 6213 downloads so far.

How do I install google-forms?

Run "/install google-forms" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is google-forms free?

Yes, google-forms is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does google-forms support?

google-forms is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created google-forms?

It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.5.

💬 Comments