MCP Reference: calendarmcp.googleapis.com

Lista os eventos da agenda em um determinado calendário que atendem às condições fornecidas.

Principais recursos:

• Qualquer ID de agenda, que pode ser a agenda principal do usuário ou outras.
• Correspondência de palavra–chave.
• Filtragem de período.
• Recupera TODOS os eventos que correspondem às restrições de tempo e palavra-chave.

Use a ferramenta search_events se:

• Você precisa encontrar os eventos mais relevantes (K principais) em vez de todos os eventos que atendem às restrições.
• Você precisa de recursos de pesquisa semântica.
• Você está pesquisando apenas a agenda principal do usuário para informações específicas.

Use essa ferramenta para consultas como:

• O que tenho na agenda amanhã?
• O que tenho na agenda para 14 de julho de 2025?
• Quais são minhas reuniões na próxima semana?
• Tenho algum conflito esta tarde?

Exemplo:

list_events(
    start_time='2024-09-17T06:00:00',
    end_time='2024-09-17T12:00:00',
    page_size=10
)
# Returns up to 10 calendar events between 6:00 AM and 12:00 PM on September 17, 2024 from the user's primary calendar.

Retorna um único evento de uma determinada agenda.

Use essa ferramenta para consultas como:

• Receber detalhes da reunião da equipe.
• Mostrar o evento com o ID event123 na minha agenda.

Exemplo:

get_event(
    event_id='event123'
)
# Returns the event details for the event with id `event123` on the user's primary calendar.

Retorna as agendas na lista de agendas do usuário.

Use essa ferramenta para consultas como:

• Quais são todas as minhas agendas?

Exemplo:

list_calendars()
# Returns all calendars the authenticated user has access to.

Sugere períodos em uma ou mais agendas. Para acessar a agenda principal, adicione "principal" no campo attendee_emails.

Use essa ferramenta para consultas como:

• Quando todos nós estamos livres para uma reunião?
• Encontre um horário de 30 minutos em que ambos estejam disponíveis.
• Verifique se jane.doe@google.com está livre na manhã de segunda-feira.

Exemplo:

suggest_time(
    attendee_emails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    start_time='2024-09-10T00:00:00',
    end_time='2024-09-17T00:00:00',
    duration_minutes=60,
    preferences={
        'start_hour': '09:00',
        'end_hour': '17:00',
        'exclude_weekends': True
    }
)
# Returns up to 5 suggested time slots where both users are available for at least one hour between 9:00 AM and 5:00 PM on weekdays from September 10 through September 16, 2024.

Cria um evento na agenda.

Use essa ferramenta para consultas como:

• Crie um evento na minha agenda para amanhã às 14h chamado "Reunião com Jane".
• Agende uma reunião com john.doe@google.com na próxima segunda-feira, das 10h às 11h.

Exemplo:

create_event(
    summary='Meeting with Jane',
    start_time='2024-09-17T14:00:00',
    end_time='2024-09-17T15:00:00'
)
# Creates an event on the primary calendar for September 17, 2024 from 2pm to 3pm called 'Meeting with Jane'.

Atualiza um evento da agenda.

Use essa ferramenta para consultas como:

• Atualize o evento "Reunião com Jane" para ser uma hora depois.
• Adicione john.doe@google.com à reunião de amanhã.

Exemplo:

update_event(
    event_id='event123',
    summary='Meeting with Jane and John'
)
# Updates the summary of event with id 'event123' on the primary calendar to 'Meeting with Jane and John'.

Exclui um evento da agenda.

Use essa ferramenta para consultas como:

• Exclua o evento com o ID event123 na minha agenda.

Para cancelar ou recusar um evento, use a ferramenta respond_to_event.

Exemplo:

delete_event(
    event_id='event123'
)
# Deletes the event with id 'event123' on the user's primary calendar.

Responde a um evento.

Use essa ferramenta para consultas como:

• Aceite o evento com o ID event123 na minha agenda.
• Recuse a reunião com Jane.
• Cancele minha próxima reunião.
• Aceite provisoriamente a reunião de planejamento.

Exemplo:

respond_to_event(
    event_id='event123',
    response_status='accepted'
)
# Responds with status 'accepted' to the event with id 'event123' on the user's primary calendar.