getnote-mcp

Overview

This MCP server provides comprehensive integration with GetNote, a personal note management application. It exposes numerous tools for AI models to interact with notes, including creating new notes (plain text, links, or images), updating existing notes, deleting notes, adding tags, and performing semantic searches across all notes or within specific knowledge bases. The server supports both OAuth authentication and manual API key configuration, making it accessible for various use cases. It also features advanced functionality like image upload workflows, note sharing, and integration with external content creators' blogs and live streams.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list_notes

  Get a paginated list of notes

  Try:Show me my recent notesTry:List all my notes
• get_note

  Get details of a specific note

  Try:Show me the details of note 123Try:Retrieve my meeting notes
• save_note

  Create a new note (text, link, or image)

  Try:Save this meeting noteTry:Create a note for this articleTry:Bookmark this link
• update_note

  Update an existing note

  Try:Update my shopping listTry:Modify the meeting notes
• delete_note

  Delete a note (moves to trash)

  Try:Remove the old draftTry:Delete that note
• recall

  Global semantic search across all notes

  Try:Find notes about project planningTry:Search for meeting notes last month
• create_topic

  Create a new knowledge base

  Try:Create a topic for researchTry:Make a new collection for articles
• list_topics

  Get a list of all knowledge bases

  Try:Show me my topicsTry:List all my collections
• recall_knowledge

  Search within a specific knowledge base

  Try:Search my research topic for AITry:Find in my project collection
• upload_image

  Upload an image and get URL for notes

  Try:Upload this image to my notesTry:Add this screenshot to my collection
• add_note_tags

  Add tags to a note

  Try:Tag this note as urgentTry:Add work and project tags
• share_note

  Generate a shareable link for a note

  Try:Share my project notesTry:Create a link for this article

Comparable tools

Installation

# Direct execution (recommended, no cloning needed)
npx @getnote/mcp

# Or global installation
npm install -g @getnote/mcp

{
  "mcpServers": {
    "getnote": {
      "command": "node",
      "args": ["/path/to/getnote-mcp/dist/index.js"],
      "env": {
        "GETNOTE_API_KEY": "your_api_key_here",
        "GETNOTE_CLIENT_ID": "your_client_id_here"
      }
    }
  }
}

FAQ

What note types can I create through this MCP server?

The server supports three note types: plain_text (default), link (requires link_url), and img_text (requires image_urls). Other note types like voice notes can only be created through the GetNote app or web interface.

How does authentication work with this MCP server?

You can use either OAuth authentication (simply say 'please help me authorize GetNote' in your AI chat) or manually configure your API Key and Client ID via environment variables or CLI flags.

Compare getnote-mcp with