OneNote

Interaja com o Microsoft OneNote usando modelos de linguagem de IA como Claude e outros LLMs.

Documentação

Servidor MCP OneNote

Um servidor Model Context Protocol (MCP) que permite que modelos de linguagem de IA, como Claude e outros LLMs, interajam com o Microsoft OneNote.

Este projeto é baseado em azure-onenote-mcp-server por Zubeid Hendricks, com modificações para simplificar a autenticação e melhorar a usabilidade.

O que isso faz?

Este servidor permite que assistentes de IA:

Acessem seus blocos de anotações, seções e páginas do OneNote
Criem novas páginas em seus blocos de anotações
Pesquisem em suas anotações
Leiam o conteúdo completo das anotações, incluindo formatação HTML e texto
Analisem e resumam suas anotações diretamente

Tudo isso acontece diretamente pela interface de IA, sem que você precise mudar de contexto.

Uso com Assistentes de IA

Configuração para Cursor

Clone este repositório e siga os passos de instalação abaixo
Inicie o servidor MCP: npm start
Registre o servidor no Cursor:
- Abra as preferências do Cursor (Cmd+, no Mac ou Ctrl+, no Windows)
- Vá para a aba "MCP"
- Adicione um novo servidor MCP com estas configurações:
  - Nome: onenote
  - Comando: node
  - Argumentos: ["/path/to/your/onenote-mcp.mjs"] (use caminho absoluto)
Aqui está o exemplo completo de configuração JSON:
```
{
  "mcpServers": {
    "onenote": {
      "command": "node",
      "args": ["/absolute/path/to/your/onenote-mcp.mjs"],
      "env": {}
    }
  }
}
```
Reinicie o Cursor
No Cursor, agora você pode interagir com seus dados do OneNote usando linguagem natural:

Can you show me my OneNote notebooks?
Create a new page in my first notebook with a summary of this conversation
Find notes related to "project planning" in my OneNote

Na primeira vez que você perguntar sobre o OneNote, a IA o guiará pelo processo de autenticação.

Configuração para Claude Desktop (ou outros assistentes compatíveis com MCP)

Clone este repositório e siga os passos de instalação abaixo
Inicie o servidor MCP: npm start
Nas configurações do Claude Desktop, adicione o servidor MCP do OneNote:
- Nome: onenote
- Comando: node
- Argumentos: ["/path/to/your/onenote-mcp.mjs"] (use caminho absoluto)
Exemplo de configuração JSON:
```
{
  "mcpServers": {
    "onenote": {
      "command": "node",
      "args": ["/absolute/path/to/your/onenote-mcp.mjs"],
      "env": {}
    }
  }
}
```
Agora você pode pedir ao Claude para interagir com seus dados do OneNote

Recursos

Autenticação com o Microsoft OneNote usando fluxo de código de dispositivo (sem necessidade de configuração do Azure)
Listar todos os blocos de anotações, seções e páginas
Criar novas páginas com conteúdo HTML
Ler o conteúdo completo das páginas, incluindo formatação HTML
Extrair texto para análise e resumos de IA
Resumir o conteúdo de todas as páginas em uma única operação
Ler o conteúdo completo de todas as páginas em um formato legível
Pesquisar em suas anotações

Instalação

Pré-requisitos

Node.js 16 ou superior (instale em nodejs.org)
Uma conta Microsoft ativa com acesso ao OneNote
Git (instale em git-scm.com)

Passo 1: Clone o Repositório

git clone https://github.com/yourusername/onenote-mcp.git
cd onenote-mcp

Passo 2: Baixe o SDK TypeScript

Este projeto requer o SDK TypeScript do MCP, que precisa ser baixado separadamente:

git clone https://github.com/modelcontextprotocol/typescript-sdk.git
cd typescript-sdk
npm install
npm run build
cd ..

Passo 3: Instale as Dependências do Projeto

npm install

Passo 4: Inicie o Servidor MCP

npm start

Isso iniciará o servidor MCP e você verá uma mensagem:

Server started successfully.
Use the "authenticate" tool to start the authentication flow,
or use "saveAccessToken" if you already have a token.

Passo 5: Autentique-se Através do Seu Assistente de IA

Depois que o servidor estiver em execução, você pode autenticar diretamente pelo seu assistente de IA:

No Cursor, no Claude Desktop da Anthropic ou em qualquer assistente compatível com MCP, peça para autenticar com o OneNote:
```
Can you authenticate with my OneNote account?
```
A IA acionará o fluxo de autenticação e fornecerá:
- Uma URL (geralmente microsoft.com/devicelogin)
- Um código para inserir
Acesse a URL, insira o código e faça login com sua conta Microsoft
Após a autenticação bem-sucedida, você pode começar a usar o OneNote com seu assistente de IA

Ferramentas MCP Disponíveis

Após a autenticação, as seguintes ferramentas estão disponíveis para uso pelos assistentes de IA:

Nome da Ferramenta	Descrição
`authenticate`	Iniciar o fluxo de autenticação da Microsoft
`listNotebooks`	Obter uma lista de todos os seus blocos de anotações do OneNote
`getNotebook`	Obter detalhes de um bloco de anotações específico
`listSections`	Listar todas as seções em um bloco de anotações
`listPages`	Listar todas as páginas em uma seção
`getPage`	Obter o conteúdo completo de uma página específica, incluindo formatação HTML
`createPage`	Criar uma nova página com conteúdo HTML
`searchPages`	Pesquisar páginas em seus blocos de anotações

Exemplos de Interação

Aqui estão alguns exemplos de como você pode interagir com o MCP do OneNote através do seu assistente de IA:

User: Can you show me my OneNote notebooks?
AI: (uses listNotebooks) I found 3 notebooks: "Work", "Personal", and "Projects"

User: What sections are in my Projects notebook?
AI: (uses listSections) Your Projects notebook has the following sections: "Active Projects", "Ideas", and "Completed"

User: Create a new page in Projects with today's date as the title
AI: (uses createPage) I've created a new page titled "2025-04-12" in your Projects notebook

User: Find all my notes about machine learning
AI: (uses searchPages) I found 5 pages with content related to machine learning...

User: Can you read and summarize my notes on the "Project Requirements" page?
AI: (uses getPage) Based on your "Project Requirements" page, here's a summary: The project requires Python 3.8+, integration with AWS services, and completion by Q3. Key deliverables include a web dashboard, API, and documentation...

User: Extract all the action items from my "Team Meeting" notes
AI: (uses getPage) Here are all the action items from your "Team Meeting" notes:
1. John to complete API documentation by Friday
2. Sarah to schedule design review meeting
3. Team to finalize Q3 roadmap by end of month

User: Summarize content of all my OneNote pages
AI: (runs get-all-page-contents.js) Here's a summary of all your pages:
- Questions: Contains strategic business questions about competitor analysis
- 2025-04-12: Discussion about monetization strategy for bank transfers
- Role Specification: Details about the Chief Payments Officer position
...

User: I want to read through all my OneNote pages so I can ask questions about them
AI: (runs read-all-pages.js) I've retrieved the full content of all your pages in a readable format. Now you can ask me specific questions about any of the content.

Avançado: Uso Direto de Scripts

Para fins de teste ou desenvolvimento, você também pode usar os scripts fornecidos diretamente:

# Authenticate with Microsoft
npm run auth

# List your notebooks
npm run list-notebooks

# List sections in your first notebook
npm run list-sections

# List pages in the first section
npm run list-pages

# Create a new page
npm run create-page

# Summarize content of all pages
node get-all-page-contents.js

# Read full content of all pages
node read-all-pages.js

Solução de Problemas

Problemas de Autenticação

Se a autenticação falhar, certifique-se de usar um navegador moderno sem prevenção de rastreamento
Tente limpar cookies e cache do navegador
Se você receber erros de "expired_token", reinicie o processo de autenticação

O Servidor Não Inicia

Verifique se o Node.js está instalado (versão 16+): node --version
Certifique-se de que todas as dependências estão instaladas: npm install
Verifique se o SDK TypeScript foi compilado corretamente

A IA Não Consegue Conectar ao Servidor

Garanta que o servidor MCP esteja em execução (npm start)
Verifique as configurações do seu assistente de IA para garantir que ele esteja configurado para usar MCP
Para o Cursor, certifique-se de que seja a versão mais recente que suporta MCP

Notas de Segurança

Os tokens de autenticação são armazenados localmente em .access-token.txt
Os tokens concedem acesso aos seus dados do OneNote, então mantenha-os seguros
Os tokens expiram após algum tempo, exigindo reautenticação
Nenhuma configuração do Azure ou chaves de API são necessárias

Créditos

Este projeto é baseado no azure-onenote-mcp-server por Zubeid Hendricks, com foco em simplificar o processo de autenticação e melhorar a experiência do usuário com assistentes de IA.

Licença

Este projeto é licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes