skills.rest
TylerSimons1127
TylerSimons1127COMMUNITY
Explore all skills by this author →
GitHub

hermes-mcp-management

Enable, disable, and troubleshoot Hermes MCP servers via profile-aware config commands.

Updated Aug 21, 2026
Search Tags:#troubleshooting#oauth#cli#MCP#config#server management#hermes
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill hermes-mcp-management-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-mcp-management
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/devops/hermes-mcp-management
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill hermes-mcp-management-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Hermes MCP servers can appear stuck in a disabled state, the hermes mcp enable subcommand may not exist in your build, and reading the base config.yaml instead of the active profile's file leads to misleading results. This Skill provides the verified command paths and pitfalls for reliably managing MCP server enablement. ## Core Features & Use Cases - Enable/Disable via CLI: Uses hermes config set "mcp_servers.<name>.enabled" against the active profile config located with hermes config path, since config.yaml is blocklisted from direct file edits. - Troubleshooting Reverts: Diagnoses servers that re-disable themselves due to the validate_mcp_server_entry security validator, and handles the hermes mcp list crash caused by string-typed server entries. - OAuth Remote Servers: Walks through manual Google Cloud OAuth client registration for hosted MCP servers (Gmail, Drive, Calendar) that lack Dynamic Client Registration. - Use Case: You run hermes mcp enable time and get invalid choice: 'enable'. This Skill shows you to locate the real profile config, flip the enabled flag with hermes config set, and verify with hermes mcp list. ## Quick Start Ask the agent to enable the disabled MCP server named 'time' in the active Hermes profile and verify it shows as enabled.

Frequently Asked Questions about hermes-mcp-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable an MCP server in Hermes when 'hermes mcp enable' fails?▼

The enable subcommand does not exist in some Hermes builds. Run hermes config set "mcp_servers.<name>.enabled" true instead, which writes to the active profile's config file, then verify with hermes config get and hermes mcp list.

Why does my Hermes MCP server keep switching back to disabled?▼

A security validator called validate_mcp_server_entry force-sets enabled to false on entries it flags as suspicious during config load and persists the change. Fix the server's command or args so it passes validation, then set enabled to true again.

Why does hermes mcp list show different state than my config.yaml?▼

The CLI loads the active profile's config file, not the base config.yaml. Run hermes config path to find the real file (e.g. profiles/vibe/config.yaml) and use hermes config get as the source of truth instead of reading YAML directly.

How do I connect Hermes to Google Gmail or Drive MCP servers with OAuth?▼

Google's hosted MCP servers lack Dynamic Client Registration, so create an OAuth client ID in Google Cloud Console with redirect URI http://127.0.0.1:8080/callback, add client_id and client_secret under the server's oauth key in the profile config, then run hermes --profile <active> mcp login gmail.

Why does hermes mcp list crash with 'string indices must be integers'?▼

A server entry stored as a bare string instead of a dict triggers a TypeError at mcp_config.py, though the status table still prints before the crash. Fix it by re-adding that server as a proper object with hermes mcp add.

Related Skills

Explore More Software Engineering Skills→
GitnappGitnapp

hermes-profile-config

Migrate Hermes Agent profile configurations across config.yaml and .env files.

Community
Advanced
elderbernardielderbernardi
1

excrtx-integrate-mcp

Install, configure, and test MCP servers in the Hermes runtime.

Community
Intermediate
MaiconGambiniMaiconGambini

harness-mcp-inventory

Audits MCP server configurations across OpenCode and Cursor files for drift and inline secrets.

Community
Basic
sayonarisayonari

mcp_slack_setup

Configure and authenticate the official Slack MCP server in Claude Code.

Community
Intermediate