Skip to content

MCP server exposing open-cli-collective CLI tools to Claude Code

License

Notifications You must be signed in to change notification settings

open-cli-collective/open-cli-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open CLI MCP Server

An MCP (Model Context Protocol) server that exposes CLI tools from the open-cli-collective as tools for Claude Code and other MCP-compatible clients.

Included Tools

CLI Binary Description
jira-ticket-cli jtk Jira Cloud ticket management
slack-chat-api slck Slack workspace interaction
confluence-cli cfl Confluence page and space management
newrelic-cli nrq New Relic observability platform
google-readonly gro Read-only Google services (Gmail, Calendar, Contacts, Drive)

Installation

Prerequisites

  • Python 3.10+
  • Homebrew (for installing the CLI tools)

Install the CLI Tools

# Add the open-cli-collective tap
brew tap open-cli-collective/tap

# Install the tools you need (all are casks)
brew install --cask open-cli-collective/tap/jtk
brew install --cask open-cli-collective/tap/slck
brew install --cask open-cli-collective/tap/cfl
brew install --cask open-cli-collective/tap/nrq
brew install --cask open-cli-collective/tap/gro

Install the MCP Server

# Clone the repository
git clone https://github.com/open-cli-collective/open-cli-mcp.git
cd open-cli-mcp

# Install Python dependencies
pip install -r requirements.txt

Configuration

Claude Code

Add to your Claude Code MCP configuration (~/.claude/mcp_servers.json):

{
  "open-cli-mcp": {
    "command": "python3",
    "args": ["/path/to/open-cli-mcp/server.py"]
  }
}

Other MCP Clients

The server runs via stdio transport. Configure your client to execute:

python3 /path/to/open-cli-mcp/server.py

Usage

Once configured, the MCP server exposes these tools:

Generic CLI Access

  • cli_help(cli, subcommand?) - Get help for any CLI or subcommand
  • jira_cli(args) - Run any jtk (Jira) command
  • slack_cli(args) - Run any slck (Slack) command
  • confluence_cli(args) - Run any cfl (Confluence) command
  • newrelic_cli(args) - Run any nrq (New Relic) command
  • google_cli(args) - Run any gro (Google) command (Gmail, Calendar, Contacts, Drive)

Convenience Wrappers

  • jira_get_issue(issue_key) - Get a Jira issue by key
  • slack_search_messages(query, count?) - Search Slack messages
  • confluence_search(query, limit?) - Search Confluence pages
  • gmail_search(query, limit?) - Search Gmail messages
  • calendar_today() - Get today's calendar events
  • drive_search(query, limit?) - Search Google Drive files

Tool Management

  • list_tools_status() - Show installed tools and versions
  • check_for_updates() - Check for available updates
  • update_tools(tools?) - Update tools via Homebrew
  • install_missing_tools() - Install any missing tools

Examples

# Get help for jtk (Jira)
cli_help("jtk")

# Get a Jira issue
jira_get_issue("PROJ-1234")

# Search Slack
slack_search_messages("deployment failed", count=10)

# Search Confluence
confluence_search("API documentation", limit=5)

# Search Gmail
gmail_search("from:boss@company.com", limit=10)

# Get today's calendar
calendar_today()

# Search Google Drive
drive_search("quarterly report", limit=5)

# Check tool versions
list_tools_status()

Development

# Install dev dependencies
pip install -r requirements.txt

# Run the server directly
python3 server.py

Contributing

Contributions are welcome! Please see the open-cli-collective organization for contribution guidelines.

License

MIT License - see LICENSE for details.

About

MCP server exposing open-cli-collective CLI tools to Claude Code

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages