File Opener

Opens files with system applications or reveals them in Finder via MCP, with optional app specification.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "timbotgpt-file-opener-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "file-opener-mcp"
      ]
    }
  }
}

You can open files or reveal them in Finder using a lightweight MCP server that integrates with Claude Desktop. It handles validating file existence and launching system applications, making it easy to work with local documents, images, or folders from your workflow.

How to use

You run a client that talks to the File Opener MCP Server, then use its tools to open files with your preferred application or to reveal their location in Finder. Use the available actions to specify the path and, if desired, the application to open with. The server ensures the path exists before attempting to open it and reports errors clearly if something goes wrong.

How to install

Prerequisites you need before installing:

Node.js 16+ is required
npm is used for installation and starting the server
Claude Desktop MCP support is assumed

Step by step installation and testing you can follow exactly:

npm install -g file-opener-mcp

git clone https://github.com/TIMBOTGPT/file-opener-mcp.git
cd file-opener-mcp

npm install

npm start

Configuration and usage notes

To connect Claude Desktop to this MCP server, you can configure the MCP server entry in your Claude Desktop setup. You have two options to run the server via MCP in your environment.

{
  "mcpServers": {
    "file_opener": {
      "command": "npx",
      "args": ["-y", "file-opener-mcp"],
      "description": "Open files with system applications"
    }
  }
}

Usage examples

Open a specific file with a chosen application (for example, Preview on macOS):

{
  "name": "open_file",
  "arguments": {
    "path": "/path/to/documents/report.pdf",
    "application": "Preview"
  }
}

Reveal a file in Finder:

{
  "name": "reveal_in_finder",
  "arguments": {
    "path": "/path/to/documents/report.pdf"
  }
}

Available tools

open_file

Open a file or directory with the system's default application, or optionally specify a particular application to use.

reveal_in_finder

Reveal a file or directory in the macOS Finder.