@claudeskillshq/mcp-server

Official MCP (Model Context Protocol) server for ClaudeSkillsHQ - Install and manage verified Claude skills directly from your Claude Desktop or Claude Code.

Quick Start

Install and configure in under 60 seconds:

npx @claudeskillshq/mcp-server

Follow the interactive prompts to:

1. Enter your ClaudeSkillsHQ email
2. Automatically configure Claude Desktop
3. Start using skills immediately

What is This?

ClaudeSkillsHQ MCP Server connects your Claude Desktop to the ClaudeSkillsHQ marketplace, giving you instant access to:

• 50+ verified professional skills (legal, finance, DevOps, and more)
• Browse and discover skills directly from Claude
• Download skill content for purchased and free skills
• Automatic updates and new skill notifications

Requirements

• Node.js 18 or higher
• Claude Desktop installed (download here)
• ClaudeSkillsHQ account (sign up here)

Installation

Automatic Setup (Recommended)

npx @claudeskillshq/mcp-server

This will:

• ✅ Detect your Claude Desktop installation
• ✅ Backup your existing config
• ✅ Add ClaudeSkillsHQ to your MCP servers
• ✅ Configure authentication

Manual Setup

If you prefer to configure manually:

1. Find your Claude Desktop config file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your config:

{
  "mcpServers": {
    "claudeskillshq": {
      "command": "npx",
      "args": ["-y", "@claudeskillshq/mcp-server"],
      "env": {
        "CLAUDESKILLSHQ_USER_EMAIL": "[email protected]",
        "CLAUDESKILLSHQ_API_URL": "https://www.claudeskillshq.com/api"
      }
    }
  }
}

3. Replace [email protected] with your ClaudeSkillsHQ email
4. Restart Claude Desktop

Usage

Once configured, you can use these MCP tools directly from Claude:

Browse Skills

Ask Claude: "List all available skills from ClaudeSkillsHQ"

This uses the list_skills tool with optional filters:

• category - Filter by category (e.g., "legal", "finance")
• search - Search by keyword
• is_free - Show only free skills
• is_featured - Show only featured skills

Get Skill Details

Ask Claude: "Show me details about the document-processor skill"

This uses the get_skill_details tool to show:

• Full description
• Installation instructions
• Dependencies
• Pricing
• Author information

List Your Skills

Ask Claude: "Show me all my ClaudeSkillsHQ skills"

This uses the list_my_skills tool to display:

• All purchased skills
• All free skills you have access to
• Download statistics

Download Skill Content

Ask Claude: "Download the content for the contract-analyzer skill"

This uses the get_skill_content tool to:

• Fetch the SKILL.md file
• Verify you have access (purchased or free)
• Return the full skill content

Configuration

Environment Variables

• CLAUDESKILLSHQ_USER_EMAIL - Your ClaudeSkillsHQ account email (required)
• CLAUDESKILLSHQ_API_URL - API endpoint (default: https://www.claudeskillshq.com/api)

Commands

# Run setup wizard
npx @claudeskillshq/mcp-server

# Uninstall
npx @claudeskillshq/mcp-server uninstall

Troubleshooting

Claude Desktop not found

Make sure Claude Desktop is installed and in the default location. If you installed it in a custom location, you'll need to manually add the MCP server to your config.

Authentication errors

Verify your email address is correct and matches your ClaudeSkillsHQ account. You can reconfigure by running:

npx @claudeskillshq/mcp-server

Skills not showing up

1. Make sure you've restarted Claude Desktop after configuration
2. Try asking Claude explicitly: "List skills from ClaudeSkillsHQ"
3. Check the MCP server logs in Claude Desktop's developer console

Permission errors

The setup script needs write access to your Claude Desktop config directory. Make sure you have the necessary permissions.

Development

Building from Source

git clone https://github.com/Stevekalangi/prompt-forge.git
cd prompt-forge/packages/mcp-server
npm install
npm run build

Testing Locally

# Build the package
npm run build

# Link it locally
npm link

# Test the setup
npx @claudeskillshq/mcp-server

Using with Local API

For development against a local API:

npx @claudeskillshq/mcp-server
# Choose "Use custom API URL"
# Enter: http://localhost:3000/api

Security

• Your email is only used for authentication with ClaudeSkillsHQ
• All communication uses HTTPS
• No sensitive data is stored locally
• Config files are backed up before modification

Support

• 📧 Email: [email protected]
• 🌐 Website: https://claudeskillshq.com
• 📚 Docs: https://claudeskillshq.com/docs
• 🐛 Issues: https://github.com/Stevekalangi/prompt-forge/issues

License

MIT License - see LICENSE file for details

Credits

Built with:

• @modelcontextprotocol/sdk - Official MCP SDK
• inquirer - Interactive CLI
• chalk - Terminal styling
• ora - Elegant terminal spinner

Made with ❤️ by the ClaudeSkillsHQ team