NoteMCP

NoteMCP

Salve em dois segundos. Encontre perguntando.

NoteMCP é um aplicativo de anotações hospedado com uma interface de primeira classe para o Model Context Protocol. Você captura notas digitando, por voz ou pela folha de compartilhamento do seu telefone. Seu assistente de IA pesquisa, lê, escreve e adiciona tags a elas — como ferramentas, não como um despejo de contexto colado.

Este repositório é a documentação pública dessa interface de agente: as ferramentas, o modelo de segurança e para onde seus dados vão. O código-fonte do aplicativo não é aberto.

• Site — https://notemcp.com
• Endpoint MCP — https://notemcp.com/mcp
• Transporte — Streamable HTTP
• Autenticação — OAuth 2.1, código de autorização + PKCE
• Versão do servidor — 0.5.0

O cadastro é gratuito, e todas as ferramentas abaixo funcionam no plano gratuito — o que o plano gratuito limita é até onde o agente pode ler no seu histórico, não o que você pode capturar.

---

Conectar

NoteMCP é um servidor remoto, então não há nada para instalar. Aponte seu cliente para o endpoint e ele o guiará pelo login.

Claude

Adicione como um conector personalizado em Configurações → Conectores, usando a URL https://notemcp.com/mcp.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "notemcp": {
      "url": "https://notemcp.com/mcp"
    }
  }
}

VS Code

mcp.json — observe que o VS Code usa servers, não mcpServers:

{
  "servers": {
    "notemcp": {
      "type": "http",
      "url": "https://notemcp.com/mcp"
    }
  }
}

---

As ferramentas

Doze ferramentas. Cinco de leitura, sete de escrita. Referência completa em TOOLS.md.

Ferramenta	O que faz	Somente leitura	Destrutiva
search_notes	Pesquisa texto, tags e metadados de links salvos	✅
list_recent_notes	O fluxo, atividade mais recente primeiro	✅
get_note	Uma nota completa, além de sua conversa	✅
list_tags	Todas as tags, com contagens de notas em tempo real	✅
get_note_asset	Uma imagem anexada a uma nota	✅
create_note	Escreve uma nova nota ou continua uma conversa
append_to_note	Adiciona markdown ao final de uma nota
replace_in_note	Altera um trecho de texto		⚠️
update_note	Substitui campos inteiros		⚠️
tag_note	Adiciona tags
untag_note	Remove tags		⚠️
delete_note	Move para a lixeira (recuperável)		⚠️

Duas regras de design moldam todas elas:

Listas nunca carregam corpos. Uma foto capturada é uma URL de dados de vários megabytes, e uma dessas em uma resposta de lista estouraria a janela de contexto de um agente. As listas retornam um rótulo e uma prévia curta; get_note retorna o corpo; uma foto incorporada é redigida para ![photo] mesmo ali, e os bytes vêm de get_note_asset somente quando um agente realmente precisa olhar.

Edição é um patch. replace_in_note altera um trecho em vez de reenviar a nota. Cada escrita aceita um if_updated_at opcional, então uma nota editada no seu telefone durante a composição produz uma escrita rejeitada em vez de uma sobrescrita silenciosa.

---

O que o agente pode e não pode fazer

Veja SECURITY.md para o modelo completo. Em resumo:

• Ele acessa apenas suas notas, limitado pelo seu ID de usuário autenticado dentro do próprio banco de dados — nunca por um parâmetro fornecido pelo agente.
• Ele não pode excluir permanentemente. delete_note é uma exclusão suave; o aplicativo pode recuperá-la.
• Ele não pode acessar a internet aberta em seu nome, com uma exceção restrita documentada em SECURITY.md.
• Ele não pode reescrever o corpo de uma nota contendo uma foto, porque o MCP só mostrou a ele ![photo] — então uma reescrita destruiria o que ele não podia ver.

Para onde seus dados vão e quais terceiros os acessam, veja DATA-FLOW.md. A política de privacidade vinculante é https://notemcp.com/privacy.

---

Exemplos de prompts

Veja examples/prompts.md.

---

Conteúdo do repositório

Arquivo	O que é
TOOLS.md	Referência completa das ferramentas com anotações
SECURITY.md	Autenticação, isolamento e raio de impacto
DATA-FLOW.md	Quais terceiros veem o quê
examples/prompts.md	Prompts que exercitam cada ferramenta
server.json	Manifesto do Registro MCP
CHANGELOG.md	Mudanças na interface do agente

Suporte

https://notemcp.com/support