Skip to main content
Glama
Hangfire MCP Server

Hangfire MCP Server

by inansen

Hangfire MCP Server

License: MIT Python 3.11+ PyPI

A Model Context Protocol (MCP) server for managing Hangfire background jobs directly from VS Code Copilot and other MCP-compatible clients. Monitor job queues, retry failed jobs, manage recurring tasks, and view real-time statistics — all without leaving your editor.

Features

  • Job Management: List, view, retry, delete, and requeue jobs

  • Recurring Jobs: List, view, trigger, pause, and resume recurring jobs

  • Statistics: View server stats, queues, and active servers

  • Auto-Discovery: Automatically finds connection strings from appsettings.json

  • Web Dashboard: Built-in web UI with real-time stats and job management

Related MCP server: Nall.Hangfire.Mcp

Quick Start (One-Click Setup)

# Clone the repo
git clone https://github.com/inansen/hangfire-mcp.git
cd hangfire-mcp

# Run cross-platform setup (Windows, macOS, Linux)
python setup.py

The setup script will:

  1. Create a virtual environment

  2. Install all dependencies (including dashboard)

  3. Prompt for your SQL Server connection string (or read from .vscode/mcp.json)

  4. Create VS Code MCP configuration

  5. Test the connection

  6. Optionally start the dashboard

Installation

pip install hangfire-mcp

Or with uvx:

uvx hangfire-mcp

Configuration

VS Code (Global Settings)

Add to your VS Code settings (settings.json):

{
  "mcp": {
    "servers": {
      "hangfire-mcp": {
        "command": "uvx",
        "args": ["hangfire-mcp", "--workspace", "${workspaceFolder}"]
      }
    }
  }
}

VS Code (Per-Project)

Create .vscode/mcp.json in your project:

{
  "servers": {
    "hangfire-mcp": {
      "command": "uvx",
      "args": ["hangfire-mcp", "--workspace", "${workspaceFolder}"]
    }
  }
}

With Explicit Connection String

Use ODBC-style connection strings:

{
  "servers": {
    "hangfire-mcp": {
      "command": "python",
      "args": ["-m", "hangfire_mcp", "--workspace", "${workspaceFolder}"],
      "env": {
        "HANGFIRE_CONNECTION_STRING": "Driver={ODBC Driver 17 for SQL Server};Server=localhost;Database=Hangfire;UID=sa;PWD=yourpassword;Encrypt=no;"
      }
    }
  }
}

Note: This project uses pyodbc and requires ODBC-format connection strings, not ADO.NET format.

Connection String Discovery

The server finds connection strings in this priority order:

  1. --connection-string CLI argument

  2. HANGFIRE_CONNECTION_STRING environment variable

  3. Auto-discover from ${workspaceFolder}/**/appsettings*.json

  4. User config at ~/.config/hangfire-mcp/connections.json (Linux/macOS) or %APPDATA%\hangfire-mcp\connections.json (Windows)

  5. Use the configure tool to set it manually

Available Tools

Job Tools

Tool

Description

list_jobs

List jobs by state (Enqueued, Processing, Succeeded, Failed, etc.)

get_job

Get detailed job info including arguments and exception details

get_job_history

Get the state history of a job

retry_job

Retry a failed job

delete_job

Delete a job

requeue_job

Move a job back to queue

Recurring Job Tools

Tool

Description

list_recurring_jobs

List all recurring jobs with cron schedules

get_recurring_job

Get recurring job details

trigger_recurring_job

Run a recurring job immediately

pause_recurring_job

Pause scheduled executions

resume_recurring_job

Resume a paused job

Statistics Tools

Tool

Description

get_stats

Server statistics (succeeded, failed, processing counts)

list_queues

List queues with pending job counts

list_servers

List active Hangfire servers

Configuration Tool

Tool

Description

configure

Set connection string for current workspace

Usage Examples

In VS Code Copilot Chat:

User: Show me failed jobs
Agent: [calls list_jobs(state="Failed")]
      Found 3 failed jobs:
      | ID | State | Job Type | Created | Reason |
      |----|-------|----------|---------|--------|
      | 123 | Failed | OrderSyncJob.Execute | 2026-03-17 10:30 | Connection timeout |
      | 124 | Failed | EmailJob.Send | 2026-03-17 10:45 | SMTP error |

User: Retry job 123
Agent: [calls retry_job(job_id=123)]
      Job 123 has been requeued to 'default' queue.

User: When did CacheRefreshJob last run?
Agent: [calls get_recurring_job(job_id="CacheRefreshJob")]
      Recurring Job: CacheRefreshJob
      - Cron: 0 */5 * * * (every 5 minutes)
      - Last Run: 2026-03-17 12:55:00
      - Queue: default

User: Trigger CacheRefreshJob now
Agent: [calls trigger_recurring_job(job_id="CacheRefreshJob")]
      CacheRefreshJob has been triggered. New job ID: 456

Web Dashboard

The package includes a built-in web dashboard for visual job management.

Installation

pip install hangfire-mcp[dashboard]

Running the Dashboard

# Windows
.\scripts\run-dashboard.ps1

# macOS / Linux
chmod +x scripts/run-dashboard.sh
./scripts/run-dashboard.sh

# Or manually (any platform)
export HANGFIRE_CONNECTION_STRING="Driver={ODBC Driver 17 for SQL Server};Server=localhost;Database=Hangfire;..."
python -m uvicorn hangfire_mcp.dashboard:app --host 127.0.0.1 --port 8080

Open http://127.0.0.1:8080 in your browser.

Dashboard Features

  • Real-time Stats: Succeeded, Failed, Processing, Enqueued, Scheduled counts

  • Job List: View all jobs with filtering by state

  • Job Actions: Retry, Delete, View details with one click

  • Recurring Jobs: Pause, Resume, Trigger recurring jobs

  • Server Status: Online/Idle/Offline status based on heartbeat

  • Auto-refresh: Updates every 10 seconds

Requirements

  • Python 3.11+

  • SQL Server with Hangfire database

  • ODBC Driver 17 for SQL Server (or compatible)

Development

# Clone the repository
git clone https://github.com/inansen/hangfire-mcp.git
cd hangfire-mcp

# Install all dependencies
pip install -e ".[dev]"

# Run tests
pytest

Contributing

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/my-feature)

  3. Commit your changes (git commit -am 'Add my feature')

  4. Push to the branch (git push origin feature/my-feature)

  5. Open a Pull Request

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    • Hacker News MCP server for ChatGPT, Claude and any AI agent: list upvoted items, list hidden items, list favorites, list my comment threads, get an item with its comments, favorite an item and hide an item in your own Hacker News account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Hacker News yourself; Cotlet does not store your password and you need no Hacker News API key. About the official Hacker News API: Hacker News has an official API, but it is read-only and public (checked 28 Oct 2026). It returns items, users and the story lists. Setup and FAQ: https://cotlet.dev/integrations/hacker-news-api-mcp-server

    • Jobber MCP server for ChatGPT, Claude and any AI agent: create quote, convert quote to job, create invoice, send invoice and list unpaid invoices in your own Jobber account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Jobber yourself; Cotlet does not store your password and you need no Jobber API key. About the official Jobber API: Yes, Jobber has a GraphQL API in its Developer Center (checked 14 Oct 2026), but you cannot use it without registering an app. Each Jobber account authorizes your app with OAuth 2.0 and tokens must be refreshed. Setup and FAQ: https://cotlet.dev/integrations/jobber-api-mcp-server

      https://cotlet.dev/mcp/v1/jobber
    • PeoplePerHour MCP server for ChatGPT, Claude and any AI agent: search projects, get project brief, search freelancers, get freelancer profile, search Offers, get Offer, list categories and get account in your own PeoplePerHour account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to PeoplePerHour yourself; Cotlet does not store your password and you need no PeoplePerHour API key. About the official PeoplePerHour API: PeoplePerHour has no public API and no developer docs (checked 12 Oct 2026). Projects, freelancers and Offers are searched and read in the website only, and the one built-in alert is an email, instant or daily, from up to 10 saved searches. Setup and FAQ: https://cotlet.dev/integrations/peopleperhour-api-mcp-server

    • Mindbody MCP server for ChatGPT, Claude and any AI agent: list classes, get class roster, search clients, get client visits, list client contracts, book client into class, cancel client booking and add client in your own Mindbody account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Mindbody yourself; Cotlet does not store your password and you need no Mindbody API key. About the official Mindbody API: Yes. Mindbody has a Public API v6, but it is for approved developers, each studio owner must activate access for their site, and it has no official MCP server (checked 5 Nov 2026). Setup and FAQ: https://cotlet.dev/integrations/mindbody-api-mcp-server

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Remote MCP server for Hangfire that exposes background jobs as dynamic MCP tools, allowing clients like VS Code to inspect, trigger, and manage jobs in-process.
      1
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Extends VS Code Copilot with MCP tools for persistent semantic memory, code indexing and RAG search, sandboxed Python/shell execution, web fetch/search, dynamic tool management via a web UI, and structured multi-step reasoning.
      -