MCP Reference: calendarmcp.googleapis.com

Este es un servidor de MCP proporcionado por la API de Google Calendar. El servidor proporciona herramientas para que los desarrolladores compilen aplicaciones basadas en LLM sobre Calendario.

Un servidor del Protocolo de contexto del modelo (MCP) actúa como proxy entre un servicio externo que proporciona contexto, datos o capacidades a un modelo de lenguaje grande (LLM) o una aplicación de IA. Los servidores de MCP conectan las aplicaciones de IA a sistemas externos, como bases de datos y servicios web, y traducen sus respuestas a un formato que la aplicación de IA pueda comprender.

Configuración del servidor

Debes configurar el servidor de MCP del Calendario antes de usarlo. Para obtener más información sobre el uso de los servidores de MCP remotos de Google y Google Cloud, consulta la Descripción general de los servidores de MCP de Google Cloud.

Extremos del servidor

Un extremo de servicio de MCP es la dirección de red y la interfaz de comunicación (por lo general, una URL) del servidor de MCP que usa una aplicación de IA (el host para el cliente de MCP) para establecer una conexión segura y estandarizada. Es el punto de contacto para que el LLM solicite contexto, llame a una herramienta o acceda a un recurso. Los extremos de MCP de Google pueden ser globales o regionales.

La API de Calendar MCP tiene el siguiente extremo de MCP global:

  • https://calendarmcp.googleapis.com/mcp/v1

Herramientas de MCP

Una herramienta de MCP es una función o capacidad ejecutable que un servidor de MCP expone a un LLM o a una aplicación de IA para realizar una acción en el mundo real.

Herramientas

El servidor de MCP de calendarmcp.googleapis.com tiene las siguientes herramientas:

Herramientas de MCP
list_events Devuelve los eventos del calendario determinado que coinciden con todas las restricciones especificadas. No se deben especificar restricciones de tiempo, a menos que el usuario lo solicite. En el caso de las búsquedas de palabras clave o temas abiertos en el calendario principal, se debe usar la herramienta search_events.
get_event Devuelve un solo evento del calendario especificado.
list_calendars Devuelve los calendarios a los que tiene acceso este usuario (su lista de calendarios). Usa esta herramienta para resolver los datos de identificación del calendario (por ejemplo, "mi calendario familiar") en su calendar_id correspondiente (identificador de correo electrónico).
suggest_time Sugiere períodos en uno o más calendarios.
create_event Crea un evento en el calendario especificado.
update_event Actualiza un evento en el calendario determinado.
delete_event Borra un evento del calendario especificado.
respond_to_event Responde a un evento en un calendario.
search_events Busca eventos en el calendario principal del usuario con la búsqueda semántica.

Obtén las especificaciones de la herramienta de MCP

Para obtener las especificaciones de las herramientas de MCP para todas las herramientas en un servidor de MCP, usa el método tools/list. En el siguiente ejemplo, se muestra cómo usar curl para enumerar todas las herramientas y sus especificaciones disponibles actualmente en el servidor de MCP.

Solicitud de Curl
curl --location 'https://calendarmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'