mcp -chatgpt-mac-app

This MCP server provides an interface to the ChatGPT macOS app via MCP. It is implemented in TypeScript and can be invoked through npx, allowing you to run the server directly from your terminal either globally or within a local project. Once started, the server exposes MCP-compatible endpoints that let you interact with ChatGPT on macOS through the MCP framework. To use it, add the server to your MCP configuration (for example as chatGPTOnMac) and then query or route interactions through the MCP client tooling. The documentation demonstrates both a global usage path and a local project setup, so you can choose the workflow that best fits your development environment.

You can verify that the server has been added to your MCP setup using claude mcp list, which should display an entry like chatGPTOnMac: npx mcp-server-chatgpt-mac-app. When running locally, the server can be started via npx mcp-server-chatgpt-mac-app in your project, or configured in your .mcp.json with the appropriate command and arguments. The server integrates with the ChatGPT macOS app and the related shortcuts, enabling streamlined interactions through MCP once connected.

Prerequisites:

• Node.js installed on your machine
• ChatGPT macOS app installed
• The "Ask ChatGPT on Mac" shortcuts available

Option A: Run via npx (no local install required)

1. Ensure Node.js is installed on your system.
2. Use the MCP workflow to add the server globally or in your project:
   • Global usage example: claude mcp add chatGPTOnMac -s user
     -- npx mcp-server-chatgpt-mac-app
   • Local project usage (in your project directory): Create or update .mcp.json with: { "mcpServers": { "chatGPTOnMac": { "command": "npx", "args": ["mcp-server-chatgpt-mac-app"], "cwd": ".", "env": {} } } }

Option B: Local development build (if you want to contribute or run from source)

1. Clone the repository: git clone https://github.com/yimajo/mcp-server-chatgpt-mac-app.git
2. Install dependencies and build: cd mcp-server-chatgpt-mac-app pnpm install pnpm build
3. Run the built server (adjust as needed for your environment): node dist/server.js

Prerequisites recap: ensure you have Node.js and the ChatGPT macOS app installed, plus the required shortcuts for integration. The instructions above cover both quick-start usage via npx and a local development workflow if you prefer to build from source.

Notes:

• The MCP server is named chatGPTOnMac in the configuration example. You can rename the key in your own .mcp.json if you prefer a different alias.
• The local config example shows an empty env object; you can add environment variables if your setup requires specific paths or API keys.
• Ensure the ChatGPT macOS app and the associated shortcuts are installed and accessible, as this server acts as a bridge between MCP and that macOS app.
• If you run into path or permission issues on macOS, verify that your terminal has appropriate permissions and that Node.js binaries are in your PATH.