Integrates with Apple's native Notes application to programmatically create, list, and read notes and folders.
Provides a comprehensive suite of tools for interacting with macOS system features, including file and folder dialogs, clipboard management, Finder integration, system notifications, screenshots, and utilities for image and PDF processing.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@macOS MCP ServerTake a screenshot of my full screen and save it to the desktop"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
macOS MCP Server
An MCP (Model Context Protocol) server for macOS system operations: file dialogs, clipboard, notifications, and Finder integration.
Features
File Dialogs: Open file/folder pickers, save dialogs, multiple selection
Clipboard: Read and write text to system clipboard
System: Notifications, open URLs, get system info
Finder: Reveal files, open with default app, get current selection
Tools
File Dialogs
Tool | Description |
| Open file picker, return selected path |
| Open folder picker, return selected path |
| Multiple file selection |
| Save file dialog with default name |
Clipboard
Tool | Description |
| Get clipboard text content |
| Set clipboard text content |
System
Tool | Description |
| Display system notification |
| Open URL in default browser |
| Get macOS version, hostname, username |
| Get screen dimensions and scale factor |
Finder
Tool | Description |
| Reveal path in Finder |
| Open file with default app |
| Get currently selected files in Finder |
| Open file with Quick Look preview |
Screenshot
Tool | Description |
| Take screenshot (full screen, region, or window) |
| Screenshot to clipboard |
Image Tools (sips)
Tool | Description |
| Get image metadata (dimensions, format, etc.) |
| Resize image (width, height, or max size) |
| Convert between formats (jpeg, png, gif, tiff, bmp, heic) |
PDF Tools
Tool | Description |
| Get number of pages in PDF |
| Merge multiple PDFs into one |
Notes App
Tool | Description |
| Create a new note |
| List all folders |
| List notes in a folder |
| Read note content by ID |
Installation
Clone and build:
git clone https://github.com/alexlock1/macos-mcp-server.git
cd macos-mcp-server
npm install
npm run buildConfiguration
Add to your MCP settings (e.g., .mcp.json or Claude Desktop config):
{
"mcpServers": {
"macos": {
"command": "node",
"args": ["/path/to/macos-mcp-server/dist/index.js"]
}
}
}Usage Examples
Pick a file
macos_pick_file({
prompt: "Select a document",
fileTypes: ["pdf", "doc", "docx"]
})Copy to clipboard
macos_clipboard_write({ text: "Hello, World!" })Show notification
macos_notify({
title: "Task Complete",
message: "Your file has been processed",
sound: "Glass"
})Get system info
macos_system_info({})
// Returns: { computerName, userName, homeDirectory, osVersion }Reveal in Finder
macos_reveal_in_finder({ path: "/Users/me/Documents/report.pdf" })Take a screenshot
macos_screenshot({
path: "/tmp/screenshot.png",
fullScreen: true
})Resize an image
macos_image_resize({
inputPath: "/path/to/image.png",
outputPath: "/path/to/resized.png",
maxSize: 800
})Get PDF page count
macos_pdf_page_count({ path: "/path/to/document.pdf" })Create a note
macos_note_create({
name: "Meeting Notes",
body: "Discussion points...",
folder: "Work"
})Requirements
Node.js 18+
macOS (uses AppleScript for all operations)
How It Works
All operations use AppleScript via osascript to interact with macOS system features. This provides native dialog appearances and full system integration.
License
MIT
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.