Skip to content
MCP server

Markdown Pipeline

Keep Jira issues as read-only Markdown files your agent can search, with source links

Runs locallyStatus and history
Pricing
Open source
Platforms
Linux, CLI, self-hosted
Runs
Locally
Version
0.1.25
Listing updated
3 days ago

About Markdown Pipeline

Markdown Pipeline is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Markdown Pipeline is a local app that copies a team's Jira Cloud issues into plain Markdown files, either in a folder on your computer or a GitHub repo you choose. Each file links back to its source and records when it was synced, and nothing is summarized or rewritten. Edits and deletions in Jira are kept in sync while the app runs, so removed issues stop being cited.

The bundled MCP server exposes search, read, list, recent_changes (for questions like what changed since yesterday), sync_status and sync. No tool writes or edits your files, and the server reads only the Markdown the app wrote plus your raw/ and wiki/ folders. mdpipeline connect --agent claude or --agent codex prints the setup for your agent.

It reads Jira with your own account's API token, so the files hold only what that account can see, and it never changes anything in Jira. A preview comes before anything is written. Linux is tested; macOS is untested and Windows works under WSL 2. Confluence, Google Drive, Notion, Linear and more are listed as coming next. The code is Apache-2.0.

Install

Run in a terminal

claude mcp add mdpipeline -- uvx mdpipeline

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mdpipeline": {
      "command": "uvx",
      "args": [
        "mdpipeline"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mdpipeline": {
      "command": "uvx",
      "args": [
        "mdpipeline"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mdpipeline": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mdpipeline"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mdpipeline": {
      "command": "uvx",
      "args": [
        "mdpipeline"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mdpipeline": {
      "command": "uvx",
      "args": [
        "mdpipeline"
      ]
    }
  }
}

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

search
Searches the synced Markdown files.
read
Reads a synced file.
list
Lists synced files.
recent_changes
Shows what changed recently, such as since yesterday.
sync_status
Reports the state of the sync.
sync
Triggers a sync.

What it does

Jira to Markdown
Syncs Jira Cloud issues into clean Markdown files.
Source link on every file
Each file records where it came from and when.
Stays current
Edits and deletions are mirrored while the app runs.
Preview before writing
Nothing is written until you approve the preview.
Read-only MCP tools
Search, read, list and recent-changes tools that never edit files.
Folder or GitHub repo
Write to a local folder or a team repo.

Good for

  • Let Claude Code or Codex search a team's Jira history
  • Ask what changed in the tracker since yesterday
  • Build a raw layer for a team LLM wiki
  • Avoid agents citing deleted issues

Pricing

Open source

Apache-2.0; free during early access

Prices change. Check markdownpipeline.com before you buy.

Markdown Pipeline FAQ

Does it change anything in Jira?

No. It only reads, using your own Jira API token.

Which platforms work?

Linux is tested, macOS is untested and Windows works inside WSL 2.

What is the licence and price?

Apache-2.0, and free during early access with no account.

Which sources are supported?

Jira Cloud and local folders today; Confluence, Notion, Google Drive and others are planned.

Is Markdown Pipeline free?

Yes. Markdown Pipeline is open source, so you can use and self-host it for free.

How do I add Markdown Pipeline to Claude Code?

Run this command in your terminal: claude mcp add mdpipeline -- uvx mdpipeline

What are the best alternatives to Markdown Pipeline?

The closest alternatives to Markdown Pipeline are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to Markdown Pipeline

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools