OneCal Calendar MCP Server

Conecte seus calendários do Google, Outlook e iCloud ao Claude, ChatGPT e qualquer cliente MCP através de um servidor seguro. Deixe seu assistente de IA ler sua agenda, verificar sua disponibilidade e criar, atualizar e excluir eventos.

Ver em onecal.io

Documentação

OneCal expõe um servidor Model Context Protocol (MCP) que permite que clientes de IA, como o ChatGPT, leiam e gerenciem seus calendários conectados em seu nome. Depois de conectado, você pode pedir ao ChatGPT para listar seus calendários, verificar sua disponibilidade e criar, atualizar ou excluir eventos de calendário.

No ChatGPT, conectores MCP personalizados são chamados de apps. Conectar o OneCal envolve alternar entre o ChatGPT e o OneCal: você começa criando o app no ChatGPT para obter sua URL de callback, usa essa URL para criar o cliente MCP no OneCal e depois volta ao ChatGPT com as credenciais que o OneCal fornece.

Pré-requisitos

Antes de começar, verifique se você tem o seguinte:

  • Uma conta OneCal com um Teste Gratuito ativo ou qualquer plano pago.
  • Pelo menos um calendário conectado à sua conta OneCal.
  • Você já está conectado à sua conta OneCal.
  • Uma assinatura paga do ChatGPT. A criação de apps personalizados está disponível apenas nos planos pagos do ChatGPT, não no plano gratuito.

Etapa 1: Comece a criar o app no ChatGPT e copie a URL de callback

1. Abra o ChatGPT e vá para Configurações > Apps.

2. Na seção Configurações avançadas, clique em Criar app.

Settings > Apps > Advanced settings > Create app

3. No diálogo Novo App, insira um Nome para o app, por exemplo: "OneCal MCP".

4. Em Conexão, mantenha URL do servidor selecionado e insira a URL do servidor MCP do OneCal:

https://mcp-server.onecal.io/mcp

5. Defina Autenticação como OAuth e clique em Configurações avançadas de OAuth.

Insira a URL do servidor MCP do OneCal e abra as Configurações avançadas de OAuth

6. Em Configurações avançadas de OAuth, defina Método de registro como Cliente OAuth definido pelo usuário e copie a URL de callback que o ChatGPT mostra. A URL de callback é exclusiva deste app, então copie-a diretamente em vez de digitá-la de memória. Você precisará dela na próxima etapa para criar o cliente MCP no OneCal.

Copie a URL de callback das configurações avançadas de OAuth do ChatGPT

Mantenha esta aba do ChatGPT aberta, pois você voltará a ela na Etapa 3.

Etapa 2: Crie um cliente MCP no OneCal

1. Em uma nova aba, navegue até https://app.onecal.io/ e abra Configurações > MCP Config.

2. Clique no botão Novo Cliente.

3. Dê ao cliente um nome reconhecível, por exemplo: "ChatGPT". Isso ajuda a identificar a qual app o cliente pertence posteriormente.

4. Deixe Suporta autenticação OAuth com segredo do cliente habilitado.

5. Escolha os escopos que deseja conceder. Os escopos controlam o que o ChatGPT pode fazer por meio do servidor MCP. Para acesso total ao calendário, habilite Ler seus eventos de calendário e Criar e modificar eventos de calendário. Perfil, e-mail e acesso offline são obrigatórios e sempre incluídos. Conceda apenas os escopos que você realmente precisa.

6. No campo URI de redirecionamento padrão, cole a URL de callback que você copiou das Configurações avançadas de OAuth do ChatGPT.

Crie o cliente MCP no OneCal e cole a URL de callback do ChatGPT

7. Clique em Criar Cliente. O OneCal gerará suas credenciais de cliente, incluindo o Client ID, o Client Secret e outros detalhes de conexão.

8. Copie e armazene esses valores com segurança. Trate o Client Secret como uma senha. Ele é exibido apenas uma vez e nunca deve ser compartilhado publicamente.

Etapa 3: Finalize o app no ChatGPT

1. Volte ao app do ChatGPT que você iniciou na Etapa 1, na seção Configurações avançadas de OAuth.

2. Cole o Client ID e o Client Secret do OneCal nos campos correspondentes.

3. Reconheça o aviso do servidor MCP personalizado do ChatGPT marcando Entendo e quero continuar e clique em Criar.

4. O ChatGPT mostra um prompt Adicionar "{app name}" ao ChatGPT com um botão Entrar com "{app name}", onde {app name} é o nome que você deu ao app anteriormente. Clique nele para iniciar o fluxo OAuth.

5. Você será redirecionado para o OneCal. Faça login se solicitado, revise o acesso que o ChatGPT está solicitando e clique em Autorizar para conceder acesso.

Autorize o ChatGPT a acessar sua conta OneCal

6. Após autorizar, o ChatGPT redireciona de volta e marca o app como conectado.

Etapa 4: Use o OneCal no ChatGPT

Depois de conectado, você pode chamar o app OneCal em uma conversa digitando @ seguido do nome do app (por exemplo, @OneCal MCP) e então sua solicitação. Por exemplo, você pode pedir ao ChatGPT para:

  • Listar seus calendários conectados.
  • Verificar sua disponibilidade para um dia ou intervalo de tempo específico.
  • Criar, atualizar ou excluir eventos de calendário.

O ChatGPT só poderá executar ações permitidas pelos escopos que você selecionou ao criar o cliente.

Solução de problemas

  • A autorização falha ou redireciona para uma página de erro: Verifique se a URI de redirecionamento adicionada no OneCal corresponde exatamente à URL de callback das Configurações avançadas de OAuth do ChatGPT. Até uma diferença de barra final fará o fluxo falhar.
  • O app pode ler, mas não pode criar ou editar eventos: Confirme se você concedeu o escopo de escrita do calendário ao criar o cliente. Você pode editar os escopos do cliente em Configurações > MCP Config.
  • Erros de cliente inválido: Verifique novamente se o Client ID e o Client Secret foram copiados corretamente, sem espaços extras.