Overview

Professional development environment for Mirth Connect and Open Integration Engine. Sync channels, browse tree views, get IntelliSense autocomplete, and manage multi-server connections—all from Visual Studio Code.

The MirthSync VS Code Extension brings the full power of MirthSync directly into your editor. Instead of switching between the terminal and VS Code, you get graphical controls for pulling and pushing configurations, browsing channels in a tree view, and managing connections to multiple Mirth servers—with IntelliSense autocomplete for Mirth JavaScript APIs.

Free to Use

The extension is free on the VS Code Marketplace. Your data stays local—credentials are stored securely via the VS Code Secrets API and never leave your machine.

System Requirements

Requirement	Details
VS Code	1.85.0 or higher
Java	JRE or JDK 8+ (required by MirthSync CLI)
MirthSync CLI	Installed via npm install -g @saga-it/mirthsync
Mirth Connect / OIE	4.5.2+ or Open Integration Engine
Mirth CLI	Ships with Mirth Connect / OIE (in $MIRTH_HOME/cli/) — required for deploy, import/export, and server status commands

Compatibility

Works with both Mirth Connect (NextGen Healthcare’s commercial product) and OIE (the open-source community edition). This is a community extension developed by Saga IT, LLC—not affiliated with or endorsed by NextGen Healthcare.

Key Capabilities

Channel Explorer

Browse channels and templates in a tree view. Expand channel groups, inspect individual channels, and right-click to pull or push—no terminal commands needed.

• Hierarchical channel group browsing
• Code template library navigation
• Right-click context menu for sync operations
• Visual organization matching your Mirth server

Learn more →

IntelliSense

Autocomplete and documentation for Mirth JavaScript APIs. Get suggestions as you type transformer and filter code, with inline documentation on hover.

• Mirth-specific API autocomplete
• Documentation hover for methods and objects
• Reduces typos and speeds up development
• Works with transformers, filters, and code templates

Learn more →

Connection Manager

Manage multiple Mirth server connections. Add, test, and switch between dev, staging, and production servers with secure credential storage.

• Multi-server connection profiles
• Secure credential storage via VS Code Secrets API
• One-click connection switching
• Connection health testing

Learn more →

Sync Operations

Pull and push configurations with GUI controls. Sync entire servers or individual channels, groups, and code templates—from the command palette, tree view, or file explorer.

• Pull/push all or individual items
• File Explorer right-click sync integration
• Force sync for conflict resolution
• Deploy channels immediately after push

Learn more →

Status Bar Controls

Toggle settings with a click. The status bar shows your active connection and provides quick toggles for ConfigMap inclusion, force sync, and deploy-after-push.

• Active connection indicator
• ConfigMap inclusion toggle
• Force sync toggle
• Deploy after push toggle

Learn more →

Diagnostics & Linting

Real-time code analysis with 14 built-in rules. Catch security issues, deprecated APIs, and common mistakes as you type — no configuration needed.

• SQL injection and credential detection
• Deprecated API warnings ($co, SerializerFactory)
• Immutable msg object violations
• Null map value checks and performance hints

Learn more →

Debugger

Attach to Mirth Connect’s Java debug port. Pre-built launch configurations for local, dev container, and remote debugging with port connectivity checks.

• JDWP attach on port 5005
• Local, dev container, and remote presets
• Port connectivity validation
• Delegates to standard Java debug adapter

Learn more →

Code Snippets

28 tab-completion templates for common Mirth patterns. Type a prefix and press Tab to expand database queries, HL7 segment access, HTTP requests, map operations, and more.

• Map operations (cmget, gmput, gcmget)
• Database queries with connection handling (dbquery)
• HL7 segment access (hl7seg)
• HTTP requests, file I/O, logging, and more

Learn more →

Dev Containers

Docker-based OIE development environments. Spin up containerized Mirth instances for local development and testing.

• Containerized OIE environments
• Consistent team development setup
• Isolated testing environments

Coming soon

Extension vs. CLI

The VS Code Extension wraps the MirthSync CLI with a graphical interface. You get the same reliable sync engine with added convenience:

Feature	CLI Only	VS Code Extension
Pull/push configurations	mirthsync pull/push commands	Command palette, tree view, or right-click
Browse channels	File explorer after pull	Live tree view with server structure
Manage connections	CLI flags per command	Saved profiles with secure credentials
IntelliSense	Third-party extensions	Built-in Mirth API autocomplete
Status indicators	Terminal output	Status bar with toggle controls
Code diagnostics	—	14 built-in linting rules
Debugger	—	Java debug attach configuration
Code snippets	—	28 Mirth-specific templates
Git operations	Separate Git commands	Integrated git status and diff

They Work Together

The extension uses the MirthSync CLI under the hood. You can freely mix extension GUI operations with terminal commands—they share the same project files and configuration.