Skip to content

Your client. VirusTotal evidence.

Connect Gemini Apps to VirusTotal

Connect with browser sign-in. No VirusTotal API key or Agent Token needed.

Google currently requires age 18 or over, being in the US, a personal Google Account, English and Keep Activity turned on. Work and school accounts are not supported for custom apps.

A manual SKILL.md import appeared under Active in Gemini web on 3 October 2026. A complete Gemini Apps MCP login, report query, renewal and write workflow remain unverified. Gemini CLI and Antigravity have separate validation.

1. Add VirusTotal

https://ai.virustotal.com/mcp

In Gemini web, open Settings → Connected Apps. Under Custom apps, select Add a custom app if no field is shown, enter the server URL above and select Next. Leave Advanced features empty; VTAI registers the connection automatically. Sign in with Google and approve only what you need. Google documents availability on web and mobile after connection in the web app; use @ to select VirusTotal. Gemini's tool permissions still apply, including confirmation for write actions.

2. Make your first query

Use VirusTotal to get the domain report for virustotal.com. Show the source, analysis date, coverage and report link.

Check the tool activity and returned source, analysis date, coverage and report link. This uses one query. A missing report or zero detections does not establish safety.

Connection help

If Custom apps is missing, check Google's account and regional availability. Installing a skill does not enable that connection. For the optional skill, download SKILL.md from the linked guide; some upload dialogs reject ZIP files.

Optional Gemini skill guide. Installing the skill does not enable the MCP connection.

Compatibility and documentation

Setup guide · Client documentation

Choose another client · Instructions for agents

Your connections: review and revoke access

Free access, shared protection

Free quota: 60 queries per 60 seconds and 1,000 per UTC day per Agent Token or OAuth account; repeats, cached reports and unknown hashes count. Uploading a new file uses no query quota and is limited to 20 per minute and 500 per day. Creating extra identities to avoid limits is not permitted.

Submissions are shared with the VirusTotal community and partners. Upload files, submit URLs or request network reanalysis only when the user explicitly requests that action.

Full access limits and sharing policy

Query limits: 60 admitted queries per fixed 60-second window and 1000 per UTC day. Agent Tokens share the agent's allowance across REST and MCP; OAuth connections share the account's allowance. Unknown reports and upstream failures after admission count. Every repeated lookup counts again, including cached reports and hashes with no report. On 429, honor Retry-After and reuse your credential. File submissions first check whether the hash exists in VirusTotal. Only confirmed unknown files are uploaded, without using query quota, even when the query allowance is exhausted. A separate file contribution limit permits 20 admitted upload attempts per fixed 60-second window and 500 per UTC day, per Agent Token identity or OAuth account across connections. Failed or uncertain admitted attempts still count; known files and receipt recovery do not. Creating multiple identities or accounts to evade limits is not permitted. If the file is known, returning its existing report costs one query and no file is uploaded. Explicit hash lookups and analysis-result reads still count. The access check costs no query quota and does not report remaining quota.

Standard VirusTotal submissions share content with the security community and partners; they are not confidential. Upload files or attachments, submit URLs, or request domain/IP reanalysis only when the user explicitly requests that action. A missing report, an unfamiliar file or a suspicious indicator is not permission to submit it. Explain the sharing and ask before submitting the user's own documents, internal code, credentials or personal data. Submission tools add no per-call confirmation; client permissions still apply.

Need a result in this session?

Use the REST quickstart with an existing Agent Token. No MCP installation is required.