Markdown Pipeline
Keep Jira issues as read-only Markdown files your agent can search, with source links
- 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 mdpipelineAdd to claude_desktop_config.json
{
"mcpServers": {
"mdpipeline": {
"command": "uvx",
"args": [
"mdpipeline"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mdpipeline": {
"command": "uvx",
"args": [
"mdpipeline"
]
}
}
}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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Claude Code Ultimate Guide
MCP serverMCP 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

Nautilus Compass Memory
MCP serverLocal-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

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools