OpenMate MCP Server (om)

An MCP (Model Context Protocol) server for managing repositories and collections with OpenMate.

Note: This MCP server work only when OpenMate CLI is installed.

Table of Contents

• OpenMate MCP Server
• OpenMate CLI
• OpenMate UI

OpenMate MCP Server

Features

• Open repositories in your favorite editor:
  • VS Code (om vs <name>)
  • Windsurf (om ws <name>)
  • Cursor (om cs <name>)
  • IntelliJ IDEA (om ij <name>)
  • PyCharm (om pc <name>)
  • Antigravity (om ag <name>)
• Preferred IDE support:
  • Set a default IDE for any repo or collection (om ide <name> <ide>)
  • Show the current default IDE (global or repo-specific) (om ide-show [name])
  • Open without specifying IDE to use default (om d <name>)
• List all repositories and collections
• Add a new repository
• Get repository path
• Remove a repository
• Add a collection
• Delete a collection
• List collection contents
• Add current directory

Installation

npm install -g openmate-mcp

Use with Claude Desktop / Windsurf / Cursor / Antigravity

Add configuration:

{
  "mcpServers": {
    "openmate": {
      "command": "openmate-mcp"
    }
  }
}

Available Tools

• list-repos: List all repositories and collections
• add-repo: Add a new repository
• get-repo: Get repository path
• remove-repo: Remove a repository
• add-collection: Create a collection
• delete-collection: Delete a collection
• list-collection: List collection contents
• set-ide: Set a preferred IDE for a repo or collection
• show-default-ide: Show global or repository-specific default IDE
• open-repo: Open a repository (IDE optional if default set)
• open-collection: Open all repos in a collection (IDE optional if default set)
• show-version: Show current version

OpenMate CLI

Installation

npm install -g openmate

For more information, visit

• OpenMate CLI (GitHub).
• OpenMate CLI (npm).

OpenMate UI

OpenMate UI is a desktop application that allows you to manage and open your local repositories in your favorite editor with quick shortcuts.

Note: supports windows for now

Download OpenMate UI from here.

✅ Features

• Add and store repository paths by name
• Initialize current directory as a repository with om init <name>
• Open repositories in your favorite editor:
  • VS Code (om vs <name>)
  • Windsurf (om ws <name>)
  • Cursor (om cs <name>)
  • IntelliJ IDEA (om ij <name>)
  • PyCharm (om pc <name>)
  • Antigravity (om ag <name>)
• Preferred IDE:
  • Set a default IDE for any repository or collection with om ide <name> <ide>
  • Show the current default IDE (global or repo-specific) with om ide-show [name]
  • Open it directly without specifying the IDE key: om d <name>
• Smart suggestions when typing partial repository names:
  • Shows matching repositories and collections as you type partial name and hit enter
  • Displays repositories and collections in separate, clearly labeled lists
  • Works with all editor commands (vs, ws, cs, ij, pc)
• Update or remove stored repos
• Print the stored path of a repo
• List all stored repositories and collections
• Collections:
  • Group related repositories together and open them all at once
  • View detailed repository list for a specific collection (om list <collection>)
  • List all collections with om list -c
• Lightweight and super easy to use
• UI: OpenMate UI is a desktop application that allows you to manage and open your local repositories in your favorite editor with quick shortcuts. (supports windows for now)

📝 License

MIT License © 2025 Pai