Alto Index
Docs Claude Desktop with Apple Notes, through Alto Index

Claude Desktop with Apple Notes

Connect Claude Desktop to your Apple Notes using MCP.

Getting started

  1. Install Alto Index: Download Alto Index from the Mac App Store and sync your Apple Notes. If you picked Documents as the export folder, they land in ~/Documents/alto-index/notes
  2. Install Claude Desktop: Download Claude Desktop from claude.ai/download if you haven’t already.
  3. Configure the MCP server: Edit your Claude Desktop configuration file to add the filesystem MCP server. The config file is located at:
    ~/Library/Application Support/Claude/claude_desktop_config.json
  4. Add the filesystem configuration: Update your claude_desktop_config.json with this configuration:
    {
      "mcpServers": {
        "filesystem": {
          "command": "npx",
          "args": [
            "-y",
            "@modelcontextprotocol/server-filesystem",
            "/Users/[YOUR_USERNAME]/Documents/alto-index"
          ]
        }
      }
    }
    Replace [YOUR_USERNAME] with your actual macOS username.
  5. Restart Claude Desktop: Quit and restart Claude Desktop to load the new configuration. You’ll see the filesystem tools appear in Claude’s interface.

Alto Index also has its own MCP server and a Claude Desktop extension: MCP server.

Available read-only tools

Claude Desktop will have access to these read-only filesystem tools to explore your exported notes:

  • read_file: Read a single note file
  • read_multiple_files: Read multiple notes at once
  • search_files: Search across all your notes
  • list_directory: Browse note folders
  • directory_tree: View folder structure
  • get_file_info: Get note metadata

Note: Alto Index exports are read-only. Claude can explore and analyze your notes but cannot modify them.

Real-world examples

Search for music notes

You: search files about ukulele in notes

Claude: I’ll search for ukulele-related content in your notes…

Found 41 files mentioning ukulele, including songs like “Birds of a Feather”, “L-O-V-E”, and “Dream a Little Dream”.

Read specific notes

You: show me my interior design notes

Claude: Let me search for interior design related notes…

I can then read specific files you’re interested in.

Analyze note patterns

You: how many notes do I have about travel?

Claude: I’ll search for travel-related content across your notes…

You have 87 notes related to travel, including trip planning, flight details, and destination research.

Tips

  • Natural language: Just ask Claude naturally, it will use the right tools. You don’t need to name them.
  • Multiple operations: Claude can chain operations together, like searching for notes and then reading the most relevant ones.
  • Pattern matching: The search tool supports regex patterns for more complex searches across your notes.
  • Private: All processing happens locally on your machine. Your notes never leave your computer.

Troubleshooting

Tools not appearing?

  • Make sure you’ve restarted Claude Desktop after editing the config
  • Check that the path in your config matches your alto-index folder
  • Verify the JSON syntax is correct (no trailing commas)

Permission errors?

  • Ensure Claude Desktop has file system permissions
  • Check that Alto Index has synced your notes successfully
  • Try using the full path without ~ shorthand