🌐 Google Sites MCP

Deja que Claude construya tu Google Site. Un servidor MCP que maneja el editor de Google Sites, porque Google nunca sacó una API para él.

Let Claude build your Google Site — an MCP server that drives the Sites editor, because Google never shipped an API for it.

Español · English

Español

Google Sites (el Sites "nuevo") no tiene API pública. La API antigua solo sirve para Sites clásico y está obsoleta. Este servidor resuelve ese hueco: abre un navegador real con tu sesión de Google y maneja el editor por ti, exponiendo todo como herramientas MCP que Claude (o cualquier cliente MCP) puede llamar.

Pídele: "Crea un portafolio con un título grande, una sección Sobre mí, mis habilidades en viñetas, una foto, un mapa de mi ciudad y un botón de contacto, y publícalo." El servidor hace los clics.

Qué puedes hacer

El contenido siempre se agrega al final de la página: tras cada inserción el servidor revisa el orden de las secciones y lo corrige si Sites colocó el bloque en otro sitio.

Requisitos

• Node.js 18 o superior

• Microsoft Edge (por defecto) o Google Chrome (GSITES_CHANNEL=chrome)

• Una cuenta de Google que pueda usar Google Sites

• Windows es la plataforma probada; macOS y Linux deberían funcionar pero no están probados

Instalación

git clone https://github.com/RXDG2908/google-sites-mcp.git
cd google-sites-mcp
npm install        # también compila (script prepare)
npm run login      # una sola vez: inicia sesión en Google en la ventana que se abre y ciérrala

Regístralo en Claude Code:

claude mcp add google-sites -- node /ruta/absoluta/a/google-sites-mcp/dist/index.js

O en la configuración de cualquier cliente MCP (Claude Desktop, etc.):

{
  "mcpServers": {
    "google-sites": {
      "command": "node",
      "args": ["/ruta/absoluta/a/google-sites-mcp/dist/index.js"]
    }
  }
}

Tu sesión de Google se guarda en ~/.google-sites-mcp-profile (cámbialo con GSITES_PROFILE_DIR). No sale de tu equipo.

Variables de entorno

Cómo funciona

Usa etiquetas accesibles, roles ARIA y los atributos data-value de Google, no posiciones en pantalla, tanto en español como en inglés. Las secciones se arrastran por su asa de una posición a la vez y lejos de los bordes del lienzo (arrastrar cerca de un borde hace que Sites desplace la página y se pase de largo).

Probado

Verificado contra el editor real con una corrida automática de punta a punta (31 comprobaciones, todas aprobadas): crear sitio, título de página, añadir página, texto (encabezado, negrita, viñetas, centrado), imagen, botón, divisor, diseño de 3 columnas, embed HTML, embed por URL, YouTube, mapa, documento de Drive, calendario, carrusel, iconos sociales, índice, grupo ocultable, separador, marcador, orden de inserción, duplicar, mover, borrar, publicar y despublicar.

Limitaciones — léelas

• Automatiza una interfaz web. Google puede cambiar el editor en cualquier momento y algún selector puede romperse. Usa gsites_snapshot / gsites_screenshot + gsites_click / gsites_type como respaldo y abre un issue.

• No puede cambiar temas, colores o fuentes; editar texto ya escrito; renombrar, reordenar o borrar páginas; gestionar permisos de uso compartido; editar la imagen de encabezado o el pie; listar o borrar tus sitios.

• Los elementos de Drive insertan el primer resultado de la búsqueda: usa una consulta específica.

• Las imágenes se suben desde archivos locales, no desde URL.

• Los selectores de Presentaciones, Hojas, Formularios y Gráficos usan el mismo flujo que Documentos pero no se probaron uno a uno.

• Un sitio y una acción a la vez; cada acción tarda unos segundos. Mover una sección lejos tarda unos 3 s por posición.

• Solo el Google Sites nuevo. El clásico no está soportado.

• No resuelve CAPTCHA ni verificación en dos pasos; inicia sesión manualmente una vez.

• gsites_publish / gsites_unpublish cambian quién puede ver un sitio. Pregunta antes de usarlos en sitios reales.

Uso responsable

Es un proyecto no oficial, sin relación ni respaldo de Google. Maneja el sitio web en el que ya iniciaste sesión, en tu nombre y con tu cuenta. Revisa los Términos de Servicio de Google para tu tipo de cuenta antes de usar automatización, y no lo uses para crear sitios en masa ni para saltarte restricciones. Tú eres responsable de lo que haga con tu cuenta.

Contribuir

Los issues y PR son bienvenidos, sobre todo: arreglos de selectores cuando Google cambie la interfaz, otros idiomas de la interfaz, reportes de macOS/Linux y los selectores sin probar. Ejecuta npm run build antes de enviar un PR.

Licencia

MIT

Related MCP server: Glance

English

Google Sites (the "new" Sites) has no public API. The old Sites API only works with classic Sites and is deprecated. This server fills the gap: it opens a real browser with your Google session and operates the editor for you, exposing everything as MCP tools that Claude (or any MCP client) can call.

Ask: "Create a portfolio site with a hero title, an About section, my skills as bullets, a photo, a map of my city and a contact button, then publish it." The server does the clicking.

What you can do

Content is always appended at the end of the page: after every insert the server checks the section order and fixes it if Sites put the block somewhere else.

Requirements

• Node.js 18+

• Microsoft Edge (default) or Google Chrome (GSITES_CHANNEL=chrome)

• A Google account that can use Google Sites

• Windows is the tested platform; macOS and Linux should work but are untested

Install

git clone https://github.com/RXDG2908/google-sites-mcp.git
cd google-sites-mcp
npm install        # also builds (prepare script)
npm run login      # one-time: sign in to Google in the window that opens, then close it

Register it with Claude Code:

claude mcp add google-sites -- node /absolute/path/to/google-sites-mcp/dist/index.js

Or in any MCP client config (Claude Desktop, etc.):

{
  "mcpServers": {
    "google-sites": {
      "command": "node",
      "args": ["/absolute/path/to/google-sites-mcp/dist/index.js"]
    }
  }
}

Your Google session is stored in ~/.google-sites-mcp-profile (change with GSITES_PROFILE_DIR). It never leaves your machine.

Environment variables

How it works

Claude ──MCP/stdio──▶ google-sites-mcp ──Playwright──▶ Edge/Chrome ──▶ sites.google.com editor
                          │                                  └─ persistent profile (your login)
                          └─ after each insert: list sections → detect new block → move to end if needed

It uses accessible labels, ARIA roles and Google's own data-value attributes rather than pixel positions, in Spanish and English UI. Sections are dragged by their handle one step at a time, away from the canvas edges (dragging near an edge makes Sites auto-scroll and overshoot).

Tested

Verified against the live editor with an automated end-to-end run (31 checks, all passing): create site, page title, add page, text (heading, bold, bullets, centered), image, button, divider, 3-column layout, HTML embed, URL embed, YouTube, map, Drive doc, calendar, carousel, social icons, table of contents, collapsible group, spacer, placeholder, insertion order, duplicate, move, delete, publish and unpublish.

Limitations — please read

• It automates a web UI. Google can change the editor at any time and a selector may break. Use gsites_snapshot / gsites_screenshot + gsites_click / gsites_type as a fallback, and open an issue.

• It cannot change themes, colors or fonts; edit text that is already written; rename, reorder or delete pages; manage sharing permissions; edit the header image or footer; list or delete your sites.

• Drive items insert the first search result — use a specific query.

• Images are uploaded from local files, not URLs.

• Slides, Sheets, Forms and Charts pickers share the Docs flow but have not been individually tested.

• One site at a time, one action at a time; each action takes a few seconds. Moving a section far away takes about 3 s per position.

• Only the new Google Sites. Classic Sites are not supported.

• It does not solve CAPTCHAs or two-step verification; sign in manually once.

• gsites_publish / gsites_unpublish change who can see a site. Ask before using them on real sites.

Responsible use

This is an unofficial project, not affiliated with or endorsed by Google. It drives the website you are already signed in to, on your behalf, with your account. Review Google's Terms of Service for your account type before using automation, and don't use it to mass-create sites or bypass any restriction. You are responsible for what it does with your account.

Contributing

Issues and PRs are welcome — especially: selector fixes after Google UI changes, other UI languages, macOS/Linux reports, and the untested pickers. Run npm run build before sending a PR.

License

MIT