Skip to main content
Glama
Sign In
Keep It MCP Server

Keep It MCP Server

by sglewis100
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Keep It MCP Server

A high-performance Model Context Protocol (MCP) server for Keep It for Mac, exposing your Keep It library, notes, folders, and tags to AI agents in Antigravity and Claude Desktop.

Warning!

This is useful to me, minimally tested, and almost exclusively vibe-coded.

Related MCP server: mcp-mac

Features & Tools

Tool

Description

keepit_search_items

Search items across title, comments, and tags with optional filtering by folder, bundle, or favorite status.

keepit_get_item

Retrieve complete item metadata, tags, file path, link, and text/markdown content.

keepit_get_current_item

Fetch the frontmost / active item currently open in Keep It.

keepit_get_selected_items

Fetch all items currently selected in the Keep It window.

keepit_create_note

Create a new Note, Markdown, or Plain Text document in a target folder/bundle with tags.

keepit_append_to_note

Append text or markdown sections to an existing note or document.

keepit_add_link

Save web bookmarks, offline single-page PDFs, paginated PDFs, or web archives into Keep It.

keepit_import_file

Import a local file from disk directly into Keep It with folder and tags.

keepit_list_folders

List all folders in your Keep It library.

keepit_list_bundles

List all bundles.

keepit_list_tags

List all available tags.

keepit_manage_tags

Add and/or remove tags on an item.

keepit_trash_item

Move an item to Deleted Items (trash).

Architecture

  • Runtime: Node.js (v18+) with TypeScript.

  • Bridge: macOS ScriptingBridge & AppleScript (osascript) via secure standard input pipes (no shell escaping vulnerabilities).

  • Speed: Fast initialization (~40ms) using compiled ES modules and JXA native JSON serialization.

Configuration

Antigravity (~/.gemini/config/mcp_config.json)

{
  "mcpServers": {
    "keepit": {
      "command": "node",
      "args": ["/Users/scott/Desktop/keepit-mcp/dist/index.js"]
    }
  }
}

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "keepit": {
      "command": "node",
      "args": ["/Users/scott/Desktop/keepit-mcp/dist/index.js"]
    }
  }
}

Development & Building

cd ~/Desktop/keepit-mcp
npm install
npm run build

Available Tools

13 tools
keepit_add_linkC

Add a web URL into Keep It, optionally saving for offline reading.

Inputs: url (required), name, tags, bundle, +3 more.

keepit_append_to_noteB

Append text or markdown content to an existing editable Keep It item.

Inputs: text (required), item_id (required).

keepit_create_noteC

Create a new Note or Markdown document in Keep It.

Inputs: text (required), name, tags, bundle, +2 more.

keepit_get_current_itemB

Get the active or frontmost item currently open in Keep It.

Inputs: no named parameters.

keepit_get_itemB

Get complete metadata, tags, file path, link, and text/markdown content for a Keep It item.

Inputs: item_id_or_name (required).

keepit_get_selected_itemsB

Get the list of currently selected items in Keep It.

Inputs: no named parameters.

keepit_import_fileC

Import an existing file from disk into Keep It.

Inputs: file_path (required), tags, bundle, folder.

keepit_list_bundlesB

List all bundles in Keep It.

Inputs: no named parameters.

keepit_list_foldersB

List all folders in Keep It.

Inputs: no named parameters.

keepit_list_tagsB

List all tags in Keep It.

Inputs: no named parameters.

keepit_manage_tagsC

Add or remove tags on a specific Keep It item.

Inputs: item_id (required), add_tags, remove_tags.

keepit_search_itemsC

Search items in Keep It by text query, folder, bundle, tag, or favorite status.

Inputs: tag, limit, query, bundle, +2 more.

keepit_trash_itemB

Move an item in Keep It to Deleted Items (trash).

Inputs: item_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.5/5.0

    Scored across 13 tools

    Disambiguation5/5

    Tools target distinct resources and actions: listing folders/bundles/tags, searching/filtering, retrieving by identity/current/selection, and creating different item types are clearly separated. The three retrieval tools are differentiated by target context (specific item, active item, selected items).

    Naming Consistency5/5

    All tool names use the keepit_ prefix with consistent snake_case and a predictable verb_noun pattern. There are no mixed conventions or vague names.

    Tool Count5/5

    13 tools is well-scoped for a Keep It integration, covering discovery, retrieval, creation, tagging, and deletion without excessive or redundant breadth. Each tool appears to earn its place.

    Completeness4/5

    Core lifecycle is covered: import/create/append/add link, search/list/tag, retrieve metadata/content, and trash. However, there are notable gaps such as folder/bundle creation, item move/rename/replace, and restore or permanent delete from trash.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-mac

      samicokar
      A
      license
      B
      quality
      D
      maintenance
      Enables AI agents to interact with macOS applications (Finder, Mail, Contacts, Reminders, Notes, Calendar, TextEdit) using AppleScript. Allows AI assistants to perform tasks like searching contacts, managing files, checking email, and creating reminders through natural language.
      24
      1
      MIT

    • Apple Notes MCP Server

      RodriguesJohn
      A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to read, create, search, update, and delete Apple Notes through natural language conversation, using JXA to communicate directly with the Notes app.
      8
      4,261 npm
      30
      MIT