upnote-lens-mcp

Deixe a IA ler, pesquisar e resumir suas notas do UpNote — e criar novas — diretamente do seu chat.

GitHub
6
Experimente este MCPPatrocinado

Documentação

upnote-lens-mcp

Um servidor MCP híbrido que permite que seu assistente de IA trabalhe com suas notas do UpNote:

  • 🔍 Encontre e pesquise notas por palavra-chave em títulos e corpos.
  • 📖 Leia e resuma — ele retorna o texto real da nota, para que a IA possa resumir, analisar ou responder perguntas sobre o que você escreveu.
  • ✍️ Crie novas notas a partir do chat.

Por baixo dos panos: as leituras vêm do banco de dados SQLite local do UpNote (somente leitura), então o conteúdo real retorna como texto; as gravações passam pelo esquema de URL upnote:// (x-callback-url) e nunca tocam no banco de dados.

O lado de gravação (esquema de URL) é baseado em chadthornton/upnote-mcp (MIT).

Uso

Depois de registrado, basta conversar com seu assistente de IA em linguagem natural — ele escolhe a ferramenta certa para você. Não há comandos ou sintaxe para memorizar. Por exemplo:

  • "Resuma minhas notas do UpNote sobre o roadmap do Q3."
  • "Encontre notas onde mencionei ajuste de Postgres e extraia os pontos-chave."
  • "O que escrevi sobre onboarding no mês passado?"
  • "Mostre-me minhas 5 notas mais recentes."
  • "Crie uma nota intitulada 'Standup 6/4' com as três prioridades de hoje."

Ler, pesquisar, resumir e criar tudo acontece por meio de conversa natural.

Requisitos

  • macOS — totalmente suportado e verificado.
  • Windows — melhor esforço. URLs são abertas pelo manipulador de esquema registrado, e o caminho padrão do banco de dados é adivinhado em %APPDATA%\UpNote\. Esse caminho não é verificado pelo autor — se as leituras falharem, defina UPNOTE_LENS_DB (veja abaixo).
  • Python 3.10+ (ou apenas uv, que traz o seu próprio).
  • Aplicativo de desktop do UpNote instalado.

Instalação e registro

🤖 Deixe a IA instalar (mais fácil)

Dê ao seu cliente MCP (Claude, etc.) um link para llms-install.md e ele executará as etapas e configurará tudo para você.

🧑 Instale você mesmo

Escolha a primeira opção que se encaixa no que você já tem. Cada opção inclui como registrá-la no Claude.

Arquivo de configuração do Claude Desktop (referenciado em cada opção):

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Opção 1 — com uv (recomendada)

Requer uv instalado uma vez (brew install uv, ou curl -LsSf https://astral.sh/uv/install.sh | sh). Depois disso, não há etapa de instalação de pacote — uvx baixa, armazena em cache e executa o upnote-lens-mcp sob demanda.

Claude Code:

claude mcp add upnote-lens -- uvx upnote-lens-mcp

Claude Desktop:

{ "mcpServers": { "upnote-lens": { "command": "uvx", "args": ["upnote-lens-mcp"] } } }

Opção 2 — com pip (se você não tiver uv)

pip install upnote-lens-mcp

Claude Code:

claude mcp add upnote-lens -- upnote-lens-mcp

Claude Desktop:

{ "mcpServers": { "upnote-lens": { "command": "upnote-lens-mcp" } } }

Opção 3 — do GitHub via HTTPS (se você não tiver pip)

Quando você não pode usar PyPI/pip, instale diretamente do repositório com uv. (Ainda não tem uv? curl -LsSf https://astral.sh/uv/install.sh | sh.)

Claude Code:

claude mcp add upnote-lens -- uvx --from git+https://github.com/AwesomeHye/upnote-lens-mcp upnote-lens-mcp

Claude Desktop:

{ "mcpServers": { "upnote-lens": { "command": "uvx", "args": ["--from", "git+https://github.com/AwesomeHye/upnote-lens-mcp", "upnote-lens-mcp"] } } }

Ferramentas

Leitura (consulta o banco de dados local → retorna texto real)

FerramentaDescrição
search_notes(query, limit=20)Pesquisa por substring em título/corpo. Retorna id, título, hora de atualização, trecho
get_note(note_id, include_html=False)Título completo + texto do corpo de uma nota (opcionalmente HTML bruto)
list_recent(limit=20)Notas atualizadas mais recentemente
list_notebooks()Cadernos com contagem de notas e pai
list_notes_in_notebook(notebook_id, limit=50)Notas dentro de um caderno
list_tags()Tags com contagem de notas
list_notes_by_tag(tag_title, limit=50)Notas que possuem uma tag

Gravação (esquema de URL upnote://)

FerramentaDescrição
create_note(title, content, notebook?, markdown=True, new_window=False)Crie uma nota. content é Markdown por padrão. notebook corresponde por nome. Tags não podem ser definidas (veja abaixo)
open_note(note_id, new_window=False)Abra uma nota existente no aplicativo
open_notebook(notebook_id)Abra um caderno no aplicativo

Limitação de tags: o esquema de URL note/new do UpNote não tem parâmetro de tag, e hashtags colocadas no corpo permanecem como texto simples em vez de se tornarem tags reais (elas só se convertem em tags quando digitadas no editor). Se você precisar de tags, adicione-as manualmente no aplicativo após a criação da nota.

Substituir o caminho do banco de dados

Se o banco de dados não estiver no local padrão (ou você estiver no Windows), aponte para ele com uma variável de ambiente:

UPNOTE_LENS_DB=/path/to/upnote.sqlite3

Caminhos padrão:

  • macOS: ~/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3
  • Windows (melhor palpite): %APPDATA%\UpNote\upnote.sqlite3

Licença

MIT. Veja LICENSE para detalhes. Os formatos de esquema de URL e a abordagem de lançamento no lado de gravação são adaptados de chadthornton/upnote-mcp (MIT).