Skip to main content
Glama
henilcalagiya

io.github.henilcalagiya/mcp-apple-notes

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
create_noteA

Create a new note with specified name and content.

Supported HTML: , , , , , Best Practices: Use semantic HTML, add tags for spacing, avoid CSS styles Folders: Root level or nested paths (up to 5 levels deep) Limitations: No special chars in name, no complex CSS/JS

Example: name: "Project Report" body: "Status: In ProgressTask 1"

create_folderA

Create a folder in Apple Notes.

Features:

  • Creates folders at root level or nested paths (up to 5 levels deep)

  • Unicode and emoji support for international characters

  • Duplicate name detection and comprehensive validation

  • iCloud account support

  • Only creates folder if parent path exists

Validation:

  • Max 128 characters, no special chars: < > : " | ? *

  • Parent paths must exist, prevents duplicates

  • Will throw error if parent path doesn't exist

read_noteA

Read a note by its primary key ID with AppleScript verification.

Security Features:

  • Verifies note exists with the given ID and name

  • Uses primary key ID for precise identification

  • Returns full note content with metadata

Output:

  • Note name, ID, folder, creation/modification dates

  • Full note content (title + body)

  • Status and read method information

read_folderA

Read a folder by its primary key ID with AppleScript verification.

Security Features:

  • Verifies folder exists with the given ID and name

  • Uses primary key ID for precise identification

  • Returns detailed folder information with contents

Output:

  • Folder metadata (name, ID, creation/modification dates)

  • Direct child folders (names and IDs)

  • Notes in the folder (names and IDs)

  • Summary counts

update_noteA

Update an existing note by its primary key ID with AppleScript verification.

Required: note_id, note_name, new_name, and new_body parameters Supported HTML: , , , , , Best Practices: Use semantic HTML, add tags for spacing, avoid CSS styles Security: AppleScript verifies ID and name match before updating

Example: note_id: "p1234" note_name: "Current Note Title" new_name: "Updated Report" new_body: "Status: CompleteDone"

rename_folderA

Rename a folder in Apple Notes by ID with enhanced name verification.

Features:

  • Renames folders by ID with double name verification

  • Comprehensive validation and duplicate detection

  • Unicode and emoji support for folder names

  • Works with root level and nested paths

Validation:

  • Max 128 characters, no special chars: < > : " | ? *

  • Prevents duplicate names in same location

  • New name cannot be same as current name

  • Verifies folder ID matches current name (double verification)

  • Gets actual folder name by ID for additional security

move_folderA

Move a folder from one location to another in Apple Notes by ID with AppleScript verification.

Features:

  • Moves folders by ID with AppleScript verification

  • Comprehensive validation and duplicate detection

  • Unicode and emoji support for folder names

  • Works with root level and nested paths

Validation:

  • Validates target path exists

  • Prevents duplicate names in target location

  • Enforces 5-level nesting depth limit

  • AppleScript verifies ID and name match the same folder

list_folder_with_structureA

List the complete folder structure with hierarchical tree format.

Features:

  • Shows all folders in hierarchical tree format

  • Displays folder nesting levels with visual indicators

  • Works with root level and nested folder structures

Output Format:

  • Tree structure with ├── and └── indicators

  • Clear hierarchy visualization

  • Folder names with proper indentation

Returns: Hierarchical tree structure of all folders in Apple Notes

delete_noteA

Delete a note by its primary key ID with AppleScript verification.

Security Features:

  • Verifies note exists with the given ID

  • Confirms note name matches before deletion

  • Uses primary key ID for precise identification

  • AppleScript handles ID and name verification automatically

  • Provides detailed error messages for troubleshooting

Output:

  • Note name, ID, deletion status and method information

delete_folderA

Delete a folder in Apple Notes by ID with AppleScript verification.

Security Features:

  • Verifies folder exists with the given ID

  • Confirms folder name matches before deletion

  • Uses primary key ID for precise identification

  • AppleScript handles ID and name verification automatically

  • Provides detailed error messages for troubleshooting

Output:

  • Folder name, ID, deletion status and method information

list_notes_with_structureA

List the complete folder structure with notes included in hierarchical tree format.

Features:

  • Shows all folders and notes in hierarchical tree format

  • Displays folder nesting levels with visual indicators

  • Lists notes within each folder

  • Works with root level and nested folder structures

Output Format:

  • Tree structure with ├── and └── indicators

  • Folder names with proper indentation

  • Notes listed under their respective folders

Returns: Hierarchical tree structure of all folders and notes in Apple Notes

list_all_notesA

List all notes across all folders with their names and IDs.

Features:

  • Lists ALL notes from ALL folders in Apple Notes

  • Shows note names, IDs, and folder locations

  • Includes notes from Recently Deleted folder

  • Provides comprehensive system overview

Output Format:

  • Numbered list of all notes

  • Note names with emoji indicators

  • Note IDs for reference

  • Folder location for each note

Returns: Complete list of all notes across all folders in Apple Notes

move_noteA

Move a note from one folder to another in Apple Notes by ID with AppleScript verification.

Features:

  • Moves notes between root folders and nested paths (up to 5 levels deep)

  • Comprehensive validation and error handling

  • Supports all folder path types (root, simple, nested)

  • Maintains note content and metadata during move

  • AppleScript verifies ID and name match before moving

Requirements:

  • Note must exist with the given ID and name

  • Target folder path must exist

  • AppleScript handles all verification automatically

search_notesA

Search for notes containing the specified keywords.

Features:

  • Searches through all notes in Apple Notes

  • Finds notes containing any of the specified keywords

  • Case-insensitive search in note content

  • Returns note details with matched keywords

Output Format:

  • Numbered list of matching notes

  • Note names, IDs, and folder locations

  • Matched keywords for each note

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/henilcalagiya/mcp-apple-notes'

If you have feedback or need assistance with the MCP directory API, please join our Discord server