Garmin Documentation MCP Server

An MCP (Model Context Protocol) server that provides comprehensive offline access to the complete Garmin Connect IQ SDK 8.2.3 documentation ecosystem for AI assistants like Claude.

Features

🚀 Fully Offline: Works with local documentation - no internet required!
📚 Complete Documentation: Access to API docs, programming guides, device reference, FAQ, and visual resources (1,407+ files)
🔍 Enhanced Search: Deep semantic search with fuzzy matching and cross-reference support
⚡ Fast: Local parsing and indexing for instant responses
🎯 Accurate Versioning: Proper API Level to SDK version mapping (fixes common confusion)
📱 Device-Specific Info: Hardware capabilities, memory limits, round device support
📖 Programming Guides: Getting started tutorials, debugging, testing, and best practices
❓ FAQ & Troubleshooting: Common issues with fonts, memory, graphics, and more

v1.0.1 New Features

✨ Fixed API Level Confusion: Now correctly shows API Level 4.2.0 (≈ SDK 6.x+) instead of misleading version info
✨ Fixed Module Functions: Critical bug fix - now properly finds all module-level functions (Math.stdev, Cryptography.createPublicKey, etc.)
✨ 3 New Tools: Device reference search, programming guides, and FAQ search
✨ Enhanced Coverage: Now indexes programming guides, device docs, FAQ resources, and personality library
✨ Better Search Results: Includes guide content in main search with comprehensive cross-references

The server provides the following tools:

Core API Tools

• search_garmin_docs: Enhanced search across modules, classes, methods, properties, constants, and guides
• get_module_details: Complete module information with corrected version mapping
• get_class_details: Detailed class information with proper SDK version context
• list_modules: Comprehensive listing of all SDK 8.2.3 modules with statistics
• get_api_examples: Code examples with SDK version-specific syntax

New Documentation Tools

• search_device_reference: Search device-specific capabilities, memory limits, and hardware features
• get_programming_guide: Access getting started guides, tutorials, and development best practices
• search_faq: Find troubleshooting info for common issues (fonts, memory, graphics, etc.)

Installation

1. Clone or download this repository
2. Copy the Garmin Connect IQ SDK 8.2.3 documentation to a docs/ folder in the project root
3. Install dependencies:

npm install

4. Build the project:

npm run build

Note: On first run, the server will automatically parse and index all documentation files. This may take a few seconds initially but subsequent runs will be instant.

Usage

Running the Server

For development:

npm run dev

For production:

npm start

Configuration for Claude Code (Recommended)

Add the MCP server using the Claude Code CLI:

# Add the server (run from any directory)
claude mcp add garmin-documentation /path/to/garmin-documentation-mcp-server/dist/index.js

# Or add at project scope for team collaboration
claude mcp add --scope project garmin-documentation /path/to/garmin-documentation-mcp-server/dist/index.js

Verify installation:

claude mcp list

Configuration for Claude Desktop

Add this server to your Claude Desktop configuration file:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "garmin-documentation": {
      "command": "node",
      "args": ["/path/to/garmin-documentation-mcp-server/dist/index.js"]
    }
  }
}

Replace /path/to/garmin-documentation-mcp-server with the actual path to your installation.

Available Tools

Core API Tools

search_garmin_docs

Enhanced search across the entire Garmin Connect IQ documentation ecosystem.

Parameters:

• query (required): Search term
• category (optional): Filter by type ("module", "class", "function", or "all")

New in v1.0.1: Now includes programming guides, device docs, and FAQ in search results with proper API Level to SDK version mapping.

get_module_details

Get detailed information about a specific module with corrected version information.

Parameters:

• module_name (required): Name of the module (e.g., "System", "Activity", "WatchUi")

Improvement: Shows API Level 4.2.0 (≈ SDK 6.x+) instead of confusing raw API levels.

get_class_details

Get detailed information about a specific class with proper SDK version context.

Parameters:

• class_name (required): Name of the class
• module_name (optional): Module containing the class

list_modules

List all available Garmin Connect IQ modules with descriptions and statistics.

get_api_examples

Get code examples for specific functionality with SDK version-specific syntax.

Parameters:

• topic (required): Topic for examples (e.g., "activity monitoring", "bluetooth", "watchface")

New Documentation Tools (v1.0.1)

search_device_reference

Search device-specific reference documentation and hardware capabilities.

Parameters:

• query (required): Search term for device capabilities, memory limits, or hardware features
• device_type (optional): Device type filter (e.g., "watch", "bike", "golf")

Use Cases: Find memory limits, round device support, hardware-specific features.

get_programming_guide

Access programming guides and tutorials for Connect IQ development.

Parameters:

• topic (required): Programming topic (e.g., "getting started", "app types", "debugging", "testing")

Coverage: Getting started guides, app development tutorials, compiler documentation, debugging tips.

search_faq

Search frequently asked questions and troubleshooting information.

Parameters:

• query (required): Search term for FAQ or troubleshooting topics

Topics Include: Font rendering, memory management, graphics optimization, music control, map integration, and more.

Example Usage with Claude

Once configured, you can ask Claude questions like:

Core API Questions

• "Search for bluetooth functionality in Garmin Connect IQ"
• "Show me details about the System module"
• "Get examples for creating a watch face"
• "What classes are available in the Activity module?"
• "List all available modules"
• "Find methods related to heart rate monitoring"

New v1.0.1 Capabilities

• "Are complications available in SDK 7?" ✅ Now answers correctly with proper version mapping
• "How do I use stdev function?" ✅ Now finds Math.stdev with complete examples
• "Show me createPublicKey usage" ✅ Now finds Cryptography.createPublicKey with examples
• "How do I get started with Connect IQ development?"
• "What are the memory limits for different Garmin devices?"
• "How do I support round devices in my app?"
• "What's the difference between API Level and SDK version?"
• "How do I troubleshoot font rendering issues?"
• "Find device reference for watch memory capabilities"

Management Commands (Claude Code)

# List all configured MCP servers
claude mcp list

# Get details about the server
claude mcp get garmin-documentation

# Remove the server
claude mcp remove garmin-documentation

Documentation Coverage

API Modules (33 modules, 282 classes, 27+ module functions)

The server provides access to all major Garmin Connect IQ modules including:

• Activity: Activity recording and monitoring
• ActivityMonitor: Daily activity metrics
• ANT: ANT wireless communication
• Application: App framework and lifecycle
• BluetoothLowEnergy: BLE communication
• Complications: Watch face complications (✅ Available in SDK 6.x+, not 4.2+ as previously confusing)
• Cryptography: Encryption, key generation, createPublicKey(), randomBytes()
• Graphics: Drawing and rendering, createBufferedBitmap(), createColor()
• Math: Statistical functions like stdev(), mean(), variance(), plus trigonometric functions
• Position: GPS and location services
• Sensor: Device sensor access
• System: Core system functions (including round device detection)
• WatchUi: User interface components
• And 20 more modules...

Additional Resources (1,407+ files total)

• Programming Guides: Getting started tutorials, app types, debugging, compiler documentation
• Device Reference: Hardware specifications, memory limits, capabilities for all supported devices
• FAQ Resources: Troubleshooting guides for fonts, graphics, memory, music, maps, and common issues
• Personality Library: UI patterns, iconography, colors, confirmations for consistent app design
• UX Guidelines: User experience best practices and design patterns

Version Accuracy

✅ Fixed Major Issue: API Level confusion resolved
✅ Proper Mapping: API Level 4.2.0 correctly mapped to ≈ SDK 6.x+
✅ SDK 7 Support Confirmed: Complications, Activity info, round devices all properly supported

License

MIT