# Google Calendar

Sincronização nos dois sentidos com o Google Calendar: eventos que reduzem a disponibilidade e tarefas que aparecem no seu calendário.

Fonte: https://ardumaker.com/pt/docs/google-calendar/

- Categoria: Reuniões e produtividade
- Estado: Disponível
- Requisitos: Sessão iniciada na ArduMaker antes de ligar o Google; Uma conta Google com Google Calendar
- Ferramentas MCP: Sem ferramentas MCP: usa-se a partir do painel.

## O que permite fazer?

- Ligar uma ou várias contas Google e vincular um ou vários calendários de cada uma.
- Trazer os eventos do Google para que reduzam a disponibilidade.
- Enviar para o Google os eventos criados na ArduMaker e as próprias tarefas com data.
- Escolher, por projeto, que calendários contam: `todos`, `especificos` ou `ninguno`, ou criar um calendário novo exclusivo para esse projeto.

## Quando convém usar?

- Para que o agendamento automático não coloque tarefas por cima de reuniões que já tem no Google.
- Para ver as tarefas de projeto no calendário que usa todos os dias.

## Como funciona na ArduMaker?

1. A conta liga-se a partir da ArduMaker e aceitam-se as permissões no Google. O calendário principal vincula-se sozinho.
2. Ao vincular um calendário faz-se uma primeira sincronização dos próximos 180 dias.
3. Depois, um processo periódico traz as alterações do Google e envia o pendente para o Google. Não é em tempo real: uma alteração pode demorar cerca de um minuto. Também se pode forçar uma sincronização manual.

- Tudo o que a ArduMaker cria no Google leva o prefixo `[AM] ` no título. Assim não volta a ser importado como evento próprio.
- Uma tarefa é enviada para o Google só se tiver responsável, data, e esse responsável tiver um calendário vinculado e ativo. Vai com o horário real; se o dia tiver um corte, divide-se em um evento por bloco.
- Os eventos que vieram do Google podem ser editados a partir da ArduMaker e a alteração volta ao Google.

> **INFO:** Mudar algo em uma tarefa pode mover no Google outra tarefa do mesmo responsável nesse dia: o dia recalcula-se por inteiro.

## O que muda realmente?

- Desligar um calendário mantém-no vinculado mas sem ler nem escrever; as tarefas que tinha são apagadas do Google no ciclo seguinte.
- Desvincular um calendário apaga do Google o que a ArduMaker tinha enviado a partir de hoje (o passado fica) e apaga os eventos importados.
- Desligar a conta faz essa limpeza em todos os calendários e pede ao Google que revogue a permissão.
- Mudar a configuração de um projeto reagenda a pessoa e move os eventos futuros para os calendários que agora correspondem.

## Esquema

**Ida e volta**

```text
Google Calendar (eventos do usuário)
  ↓
Sincronização periódica (traz alterações, ignora os [AM])
  ↓
Agenda da ArduMaker (reduz disponibilidade, reagenda tarefas)
  ↓
Fila de envio (tarefas e eventos para o Google)
```

## Resultado esperado

As próprias tarefas aparecem no Google com o prefixo `[AM] ` e os eventos do Google ocupam tempo no horário que a ArduMaker usa para agendar.

## Erros e resolução

| Mensagem ou resultado | Causa |
| --- | --- |
| `Could not refresh the Google access token, reconnect the account` | O Google já não aceita o acesso guardado; é preciso voltar a ligar. |
| `This calendar is already linked` | Esse calendário já estava vinculado. |
| `reconnected_no_refresh_token` | Voltou-se a ligar uma conta conhecida e o Google não renovou a permissão de longo prazo; convém desligar e ligar do zero. |
| `error_not_logged_in` | A link iniciou-se sem sessão na ArduMaker. |

Se uma tarefa não aparecer no Google, verifique que tem responsável e data e que o calendário está ativo, e aguarde o ciclo seguinte.

## Relação com MCP

Não há ferramentas MCP para ligar contas nem escolher calendários. O que um agente cria segue para o Google: as tarefas com `crear_tarea` e as reuniões com `crear_reunion` sincronizam-se como as criadas na web.

Referência completa de cada ferramenta: [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Calendário de projeto](https://ardumaker.com/pt/docs/calendario-de-proyecto/)
- [Tarefas](https://ardumaker.com/pt/docs/tareas/)
- [Google Meet](https://ardumaker.com/pt/docs/google-meet/)
- [Links para agendar](https://ardumaker.com/pt/docs/enlaces-para-agendar/)
- [Disponibilidade compartilhada](https://ardumaker.com/pt/docs/disponibilidad-compartida/)