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 anotações digitando, por voz ou pela folha de compartilhamento do seu celular. 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 — HTTP Streamable
• 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-o pela listagem no diretório de conectores do Claude: https://claude.ai/directory/connectors/notemcp.

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	Função	Somente leitura	Destrutiva
search_notes	Pesquisar texto, tags e metadados de links salvos	✅
list_recent_notes	O fluxo, atividade mais recente primeiro	✅
get_note	Uma anotação completa, além de sua conversa	✅
list_tags	Todas as tags, com contagens de anotações em tempo real	✅
get_note_asset	Uma imagem anexada a uma anotação	✅
create_note	Escrever uma nova anotação ou continuar uma conversa
append_to_note	Adicionar markdown ao final de uma anotação
replace_in_note	Alterar um trecho de texto		⚠️
update_note	Substituir campos inteiros		⚠️
tag_note	Adicionar tags
untag_note	Remover tags		⚠️
delete_note	Mover 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. Listas retornam um rótulo e uma prévia curta; get_note retorna o corpo; uma foto incorporada é ocultada como ![photo] até mesmo ali, e os bytes vêm de get_note_asset somente quando um agente realmente precisa olhar.

Editar é um patch. replace_in_note altera um trecho em vez de reenviar a anotação. Toda escrita aceita um if_updated_at opcional, então uma anotação editada no seu celular durante a composição produz uma escrita rejeitada em vez de uma sobrescrita silenciosa.

---

O que o agente pode e não pode fazer

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

• Ele acessa apenas suas anotações, 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 única exceção estreita documentada em SECURITY.md.
• Ele não pode reescrever o corpo de uma anotação que contém 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 está em DATA-FLOW.md. A política de privacidade vinculativa é https://notemcp.com/privacy.

---

Exemplos de prompts

Consulte 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