apple-notes-brain

v1.0.4 safe
3.0
Low Risk

MCP server for Apple Notes on macOS — read, write, and search with full Markdown round-trip. Reads via SQLite (sub-100ms, concurrent with Notes.app), writes via AppleScript (preserves iCloud sync). Part of the -brain family.

🤖 AI Analysis

Final verdict: SAFE

The package shows minimal risk indicators, with no network calls, obfuscation, or credential harvesting attempts. The subprocess calls are likely for legitimate interaction with the Apple Notes application.

  • No network calls detected
  • Subprocess calls to 'osascript' for AppleScript execution
Per-check LLM notes
  • Network: No network calls detected, which is normal and expected.
  • Shell: Subprocess calls to 'osascript' are used for executing AppleScript, likely for interacting with the Apple Notes application, which aligns with the package's presumed functionality.
  • Obfuscation: No obfuscation patterns detected, indicating low risk.
  • Credentials: No credential harvesting patterns detected, indicating low risk.
  • Metadata: The maintainer has only one package, which might indicate a new or less active account, but there are no other red flags.

📦 Package Quality Overall: Medium (6.4/10)

◈ Medium Test Suite 6.0

Partial test coverage signals detected

  • Test runner config found: pyproject.toml
◈ Medium Documentation 7.0

Some documentation present

  • Documentation URL: "Documentation" -> https://github.com/sweir1/apple-notes-brain#readme
  • Detailed PyPI description (22327 chars)
○ Low Contributing Guide 4.0

No contributing guide or governance files found

  • Development Status classifier >= Beta
◈ Medium Type Annotations 7.0

Partial type annotation coverage

  • Classifier: Typing :: Typed
  • Type checker (mypy / pyright / pytype) referenced in project
  • 150 type-annotated function signatures detected in source
✦ High Multiple Contributors 8.0

Active multi-contributor project

  • 3 unique contributor(s) across 38 commits in sweir1/apple-notes-brain
  • Small but multi-author team (3–4 contributors)

🔬 Heuristic Checks

✓ Outbound Network Calls

No suspicious network call patterns found

✓ Code Obfuscation

No obfuscation patterns detected

⚠ Shell / Subprocess Execution score 10.0

Found 6 shell execution pattern(s)

  • """ try: result = subprocess.run( ["osascript", "-"], input=script,
  • lse try: result = subprocess.run( ["osascript", "-e", _PING_SCRIPT],
  • s errors.""" try: subprocess.run( ["osascript", "-e", _PING_SCRIPT],
  • c() try: result = subprocess.run( ["osascript", "-e", _PING_SCRIPT],
  • pp") try: subprocess.run( ["osascript", "-e", 'tell application "Note
  • try: r = subprocess.run(["pgrep", "-x", "Notes"], capture_output=True, timeout=1.0)
✓ Credential Harvesting

No credential harvesting patterns detected

✓ Typosquatting

No typosquatting candidates detected

✓ Registered Email Domain

No author email provided

✓ Suspicious Page Links

All external links appear legitimate

✓ Git Repository History

Repository sweir1/apple-notes-brain appears legitimate

⚠ Maintainer History score 2.0

1 maintainer concern(s) found

  • Author "sweir1" appears to have only 1 package on PyPI (new or inactive account)
✓ Known CVE Vulnerabilities

No known vulnerabilities found in OSV database.

💡 AI App Starter Prompt

Use this prompt to build a project with apple-notes-brain 
Develop a fully-functional mini-application called 'NoteSyncPro' using the Python package 'apple-notes-brain'. This application will serve as a bridge between your local environment and Apple Notes on macOS, allowing you to manage your notes more efficiently. NoteSyncPro should have the following functionalities:

1. **Note Synchronization**: Automatically synchronize notes from Apple Notes to your local storage and vice versa. Use 'apple-notes-brain' to read notes from the SQLite database and write them back using AppleScript.

2. **Search Functionality**: Implement a robust search feature that allows users to search through their notes based on keywords. Utilize 'apple-notes-brain' to access the notes stored in SQLite and provide real-time search results.

3. **Markdown Support**: Ensure that all notes are preserved in their original Markdown format during synchronization. 'apple-notes-brain' supports full Markdown round-trip, which means it can handle Markdown formatting seamlessly.

4. **Tagging System**: Allow users to tag their notes and search by tags. Integrate 'apple-notes-brain' to store these tags alongside notes and retrieve them when needed.

5. **Version Control**: Implement version control for notes, allowing users to revert to previous versions if necessary. Use 'apple-notes-brain' to track changes and store different versions of each note.

6. **User Interface**: Develop a simple and intuitive user interface using a framework like Tkinter or PyQt. This UI should allow users to view, edit, and manage their notes easily.

7. **Security Measures**: Ensure that user data is securely handled. Use appropriate encryption methods for storing sensitive information locally.

The application should be designed to work seamlessly with Apple Notes, ensuring that any changes made through NoteSyncPro are also reflected in Apple Notes and vice versa. Additionally, the application should be able to run in the background, continuously syncing notes without user intervention.