Can I use Google Forms as a CLI?

Yes. KosmoKrator exposes a Google Forms CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Google Forms through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Google Forms tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Google Forms credentials stored?

Google Forms credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Google Forms MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Google Forms CLI for AI Agents

Use the Google Forms CLI from KosmoKrator to call Google Forms tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

7 functions 5 read 2 write Manual OAuth token auth

Submit Google Forms feedback View package source

Google Forms CLI Setup

Google Forms can be configured headlessly with `kosmokrator integrations:configure google-forms`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure google-forms --set access_token="$GOOGLE_FORMS_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor google-forms --json
kosmokrator integrations:status --json

Credentials

Authentication type: Manual OAuth token oauth2_manual_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`GOOGLE_FORMS_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`GOOGLE_FORMS_URL`	URL `url`	no	API Base URL

Call Google Forms Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call google-forms.gforms_list_forms '{
  "pageSize": 1,
  "pageToken": "example_pageToken",
  "filter": "example_filter"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:google-forms gforms_list_forms '{
  "pageSize": 1,
  "pageToken": "example_pageToken",
  "filter": "example_filter"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs google-forms --json
kosmo integrations:docs google-forms.gforms_list_forms --json
kosmo integrations:schema google-forms.gforms_list_forms --json
kosmo integrations:search "Google Forms" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Google Forms.

`google-forms.gforms_list_forms`

Read read

List Google Forms owned by the authenticated user. Returns form IDs, titles, and metadata. Supports pagination and filtering.

Parameters: pageSize, pageToken, filter

Generic CLI call

kosmo integrations:call google-forms.gforms_list_forms '{"pageSize":1,"pageToken":"example_pageToken","filter":"example_filter"}' --json

Provider shortcut

kosmo integrations:google-forms gforms_list_forms '{"pageSize":1,"pageToken":"example_pageToken","filter":"example_filter"}' --json

`google-forms.gforms_get_form`

Read read

Get the full details of a specific Google Form, including its questions, layout, and settings.

Parameters: id

Generic CLI call

kosmo integrations:call google-forms.gforms_get_form '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:google-forms gforms_get_form '{"id":"example_id"}' --json

`google-forms.gforms_create_form`

Write write

Create a new Google Form. Provide a title and optional description. The form will appear in the authenticated user's Google Drive.

Parameters: info, title, description, documentTitle

Generic CLI call

kosmo integrations:call google-forms.gforms_create_form '{"info":"example_info","title":"example_title","description":"example_description","documentTitle":"example_documentTitle"}' --json

Provider shortcut

kosmo integrations:google-forms gforms_create_form '{"info":"example_info","title":"example_title","description":"example_description","documentTitle":"example_documentTitle"}' --json

`google-forms.gforms_list_responses`

Read read

List responses submitted to a Google Form. Returns answers, timestamps, and respondent metadata. Supports pagination and filtering by date.

Parameters: id, pageSize, pageToken, filter

Generic CLI call

kosmo integrations:call google-forms.gforms_list_responses '{"id":"example_id","pageSize":1,"pageToken":"example_pageToken","filter":"example_filter"}' --json

Provider shortcut

kosmo integrations:google-forms gforms_list_responses '{"id":"example_id","pageSize":1,"pageToken":"example_pageToken","filter":"example_filter"}' --json

`google-forms.gforms_get_response`

Read read

Get a specific form response by ID. Returns all answers, the submission timestamp, and respondent metadata.

Parameters: form_id, id

Generic CLI call

kosmo integrations:call google-forms.gforms_get_response '{"form_id":"example_form_id","id":"example_id"}' --json

Provider shortcut

kosmo integrations:google-forms gforms_get_response '{"form_id":"example_form_id","id":"example_id"}' --json

`google-forms.gforms_create_response`

Write write

Submit a response to a Google Form. Provide answers keyed by question ID. Use get_form first to discover question IDs and their types.

Parameters: id, answers

Generic CLI call

kosmo integrations:call google-forms.gforms_create_response '{"id":"example_id","answers":"example_answers"}' --json

Provider shortcut

kosmo integrations:google-forms gforms_create_response '{"id":"example_id","answers":"example_answers"}' --json

`google-forms.gforms_get_current_user`

Read read

Get the authenticated Google user's profile — email, display name, and profile photo. Use this to verify the connected account.

Parameters: none

Generic CLI call

kosmo integrations:call google-forms.gforms_get_current_user '{}' --json

Provider shortcut

kosmo integrations:google-forms gforms_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`google-forms.gforms_list_forms`

List Google Forms owned by the authenticated user. Returns form IDs, titles, and metadata. Supports pagination and filtering.

Operation: Read read
Schema command: kosmo integrations:schema google-forms.gforms_list_forms --json

Parameter	Type	Required	Description
`pageSize`	integer	no	Maximum number of forms to return per page (default: 20, max: 100).
`pageToken`	string	no	Token from a previous response to fetch the next page of results.
`filter`	string	no	Filter expression. Example: "creator_email = '[email protected]'" to filter by creator.

`google-forms.gforms_get_form`

Get the full details of a specific Google Form, including its questions, layout, and settings.

Operation: Read read
Schema command: kosmo integrations:schema google-forms.gforms_get_form --json

Parameter	Type	Required	Description
`id`	string	yes	The form ID (found in the form URL or from list_forms).

`google-forms.gforms_create_form`

Create a new Google Form. Provide a title and optional description. The form will appear in the authenticated user's Google Drive.

Operation: Write write
Schema command: kosmo integrations:schema google-forms.gforms_create_form --json

Parameter	Type	Required	Description
`info`	object	no	Full form info object (JSON). Use this for advanced form creation with questions pre-configured.
`title`	string	no	The title of the form. Shown at the top of the form.
`description`	string	no	A description of the form's purpose. Shown below the title.
`documentTitle`	string	no	The title shown in Google Drive. Defaults to the form title if not set.

`google-forms.gforms_list_responses`

List responses submitted to a Google Form. Returns answers, timestamps, and respondent metadata. Supports pagination and filtering by date.

Operation: Read read
Schema command: kosmo integrations:schema google-forms.gforms_list_responses --json

Parameter	Type	Required	Description
`id`	string	yes	The form ID to list responses for.
`pageSize`	integer	no	Maximum number of responses to return per page.
`pageToken`	string	no	Token from a previous response to fetch the next page.
`filter`	string	no	Filter expression. Example: "timestamp >= 1234567890" to filter by submission time (Unix epoch).

`google-forms.gforms_get_response`

Get a specific form response by ID. Returns all answers, the submission timestamp, and respondent metadata.

Operation: Read read
Schema command: kosmo integrations:schema google-forms.gforms_get_response --json

Parameter	Type	Required	Description
`form_id`	string	yes	The form ID.
`id`	string	yes	The response ID.

`google-forms.gforms_create_response`

Submit a response to a Google Form. Provide answers keyed by question ID. Use get_form first to discover question IDs and their types.

Operation: Write write
Schema command: kosmo integrations:schema google-forms.gforms_create_response --json

Parameter	Type	Required	Description
`id`	string	yes	The form ID to submit a response to.
`answers`	object	yes	Object mapping question IDs to answer objects. Each answer should have the format: {"textAnswers": {"answers": [{"value": "your answer"}]}}.

`google-forms.gforms_get_current_user`

Get the authenticated Google user's profile — email, display name, and profile photo. Use this to verify the connected account.

Operation: Read read
Schema command: kosmo integrations:schema google-forms.gforms_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.