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 Server Take 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.
An MCP (Model Context Protocol) server for macOS system operations: file dialogs, clipboard, notifications, and Finder integration.
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
Related MCP server: mac-mcp-server
Tool | Description |
| Open file picker, return selected path |
| Open folder picker, return selected path |
| Multiple file selection |
| Save file dialog with default name |
Tool | Description |
| Get clipboard text content |
| Set clipboard text content |
Tool | Description |
| Display system notification |
| Open URL in default browser |
| Get macOS version, hostname, username |
| Get screen dimensions and scale factor |
Tool | Description |
| Reveal path in Finder |
| Open file with default app |
| Get currently selected files in Finder |
| Open file with Quick Look preview |
Tool | Description |
| Take screenshot (full screen, region, or window) |
| Screenshot to clipboard |
Tool | Description |
| Get image metadata (dimensions, format, etc.) |
| Resize image (width, height, or max size) |
| Convert between formats (jpeg, png, gif, tiff, bmp, heic) |
Tool | Description |
| Get number of pages in PDF |
| Merge multiple PDFs into one |
Tool | Description |
| Create a new note |
| List all folders |
| List notes in a folder |
| Read note content by ID |
Clone and build:
git clone https://github.com/alexlock1/macos-mcp-server.git
cd macos-mcp-server
npm install
npm run buildAdd 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"]
}
}
}macos_pick_file({
prompt: "Select a document",
fileTypes: ["pdf", "doc", "docx"]
})macos_clipboard_write({ text: "Hello, World!" })macos_notify({
title: "Task Complete",
message: "Your file has been processed",
sound: "Glass"
})macos_system_info({})
// Returns: { computerName, userName, homeDirectory, osVersion }macos_reveal_in_finder({ path: "/Users/me/Documents/report.pdf" })macos_screenshot({
path: "/tmp/screenshot.png",
fullScreen: true
})macos_image_resize({
inputPath: "/path/to/image.png",
outputPath: "/path/to/resized.png",
maxSize: 800
})macos_pdf_page_count({ path: "/path/to/document.pdf" })macos_note_create({
name: "Meeting Notes",
body: "Discussion points...",
folder: "Work"
})Node.js 18+
macOS (uses AppleScript for all operations)
All operations use AppleScript via osascript to interact with macOS system features. This provides native dialog appearances and full system integration.
MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Let ChatGPT, Claude & Cursor use your Mac: email, calendar, iMessage, Teams, files. Local, free.
OCR, transcription, file extraction, and image generation for AI agents via MCP.
Generate images, GIFs, and PDFs from HTML, URLs, or templates — from your AI agent.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/alexlock1/macos-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server