# Apple Notes

> Apple Notes is an open-source MCP server for knowledge and memory. MCP server to search, create and organise notes and folders in macOS Notes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Repository:** https://github.com/jonathanrreed/apple-mcps/tree/HEAD/AppleNotes-MCP
- **MCP Registry name:** io.github.JonathanRReed/apple-mcp-notes
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

Notes stays the system of record here: the server drives the native Notes app through AppleScript so an agent can read, create, edit, move and delete notes without a separate store. Search results include the note plaintext, so queries match body text as well as titles and tags.

It copes with multiple accounts by listing accounts and folders first, and an allowed-accounts setting can restrict which ones it touches. Every AppleScript call has a timeout, 60 seconds by default, so a stalled Notes app cannot hang a request. If a create times out it returns NOTE_CREATE_STATUS_UNKNOWN and leaves matching notes alone, so you inspect the folder before retrying.

Safety modes are safe_readonly, safe_manage and full_access, and unlike its siblings it defaults to full_access. The README suggests keeping time-sensitive items in Reminders or Calendar instead.

## Features

- **Note CRUD:** List, search, create, edit, move and delete notes.
- **Folder management:** Create, rename and delete folders.
- **Attachment listing:** Lists attachments on a note.
- **Body-text search:** Search matches note plaintext, titles and tags.
- **Account allowlist:** Limits which Notes accounts the server can use.
- **Script timeout:** Bounded AppleScript calls, 60 seconds by default.

## Good for

- Save reference material from a chat into a folder
- Search old notes by body text
- Reorganise notes across folders
- List recent notes for context
- Rename or tidy folders

## Install

### Claude Code (Terminal)

```sh
claude mcp add apple-mcp-notes -- uvx apple-mcp-notes
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "apple-mcp-notes": {
      "command": "uvx",
      "args": [
        "apple-mcp-notes"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "apple-mcp-notes": {
      "command": "uvx",
      "args": [
        "apple-mcp-notes"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "apple-mcp-notes": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "apple-mcp-notes"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "apple-mcp-notes": {
      "command": "uvx",
      "args": [
        "apple-mcp-notes"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "apple-mcp-notes": {
      "command": "uvx",
      "args": [
        "apple-mcp-notes"
      ]
    }
  }
}
```

## Tools

- `search_tools`: Lists available tools for context-constrained clients.
- `get_tool_info`: Returns details for one tool.
- `notes_health`: Checks Notes server health.
- `notes_permission_guide`: Explains how to grant Notes automation access.
- `notes_recheck_permissions`: Rechecks permissions after a macOS change.

## FAQ

### What permission does it need?

Automation access to Notes on macOS.

### What is the default safety mode?

full_access, with safe_readonly and safe_manage available.

### What happens if a create times out?

It returns NOTE_CREATE_STATUS_UNKNOWN and you should inspect the folder before retrying.

### How do I install it?

Run uvx apple-mcp-notes.

### Can locked notes be read?

Locked or unavailable note fields can come back empty.

### Is Apple Notes free?

Yes. Apple Notes is open source, so you can use and self-host it for free.

### How do I add Apple Notes to Claude Code?

Run this command in your terminal: claude mcp add apple-mcp-notes -- uvx apple-mcp-notes

### What are the best alternatives to Apple Notes?

The closest alternatives to Apple Notes are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Concord MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.

---
Source: https://ai-powered.com/mcp/apple-notes
