Agama — Redmine MCP Server
About
MCP server for Redmine. Enables AI agents to work with issues using simple natural language commands. Works just as well as a personal tool for a single developer — or deployed once and shared by the whole team.
Details
- Author
- 0xkillaflow
- Categories
- Productivity
Jump to
Setup
Install Agama — Redmine MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/0xkillaflow/agama-redmine-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
MCP server for Redmine. Enables AI agents to work with issues using simple natural language commands. Works just as well as a personal tool for a single developer — or deployed once and shared by the whole team.
MCP serverfor Redmine. Enables AI agents to work with issues using simple natural language commands.
Works just as well as a personal tool for a single developer — or deployed once and shared by the whole team.
┌──────────┐ MCP (stdio) ┌─────────────────────┐ REST/JSON ┌──────────┐ │ Agent │ ──────────────▶ │ Redmine MCP Server │ ────────────▶ │ Redmine │ │ (client) │ ◀────────────── │ (this project) │ ◀──────────── │ server │ └──────────┘ tool results └─────────────────────┘ HTTP └──────────┘
"What issues are assigned to me? Sort them by priority."
"Create a bug in the Web project: login button doesn't respond on mobile, mark it urgent."
"Summarize issue #456 and all its subtasks."
"How many hours did I log this week, broken down by project?"
- Node.js 22+
- A Redmine instance with the REST API enabled (Administration → Settings → API)
- A Redmine API key — go toMy account → API access keywhile signed in
Most MCP clients (e.g. Claude Desktop) launch the server for you — configure it once and forget it:
{ "mcpServers": { "redmine": { "command": "npx", "args": ["-y", "@0xkillaflow/agama-redmine-mcp"], "env": { "REDMINE_URL": "https://redmine.example.com", "REDMINE_API_KEY": "your-redmine-api-key" } } } }
For Claude Desktop, this goes inclaude_desktop_config.json(Settings → Developer → Edit Config). Restart the client and the Redmine tools will appear in its tool list.
To run it standalone from a shell instead:
REDMINE_URL=https://redmine.example.com REDMINE_API_KEY=your-redmine-api-key \ npx -y @0xkillaflow/agama-redmine-mcp
The server speaks MCP over stdio and logs to stderr, so stdout stays clean for the protocol.
Set via environment variables, validated at startup. See.env.examplefor a template.
File access (REDMINE_ALLOWED_DIRECTORIES)
The attachment tools are the only ones that touch your filesystem, and they may only touch it inside this allowlist — a:-separated list of absolute directories (;on Windows). It governsbothdirections: reads forredmine_upload_attachmentand writes forredmine_download_attachment.
REDMINE_ALLOWED_DIRECTORIES=/Users/you/redmine-files:/tmp/redmine-downloads
It defaults to empty, which means no local file access at all— both tools refuse every path until you opt in. That default is deliberate: an agent that can be talked into uploading a file is an agent that can be talked into uploading~/.ssh/id_rsaor the.envholding your API key. Allowlist the narrowest directory that does the job. Paths are fully resolved (..segments and symlinks included) before the check, so a symlink inside an allowed directory cannot point out of it, and downloads never overwrite an existing file.
Nineteen intent-shaped tools, each tagged with MCP safety annotations. Full reference:docs/tools.md.
Heads up:redmine_delete_issueis the tool that destroys data — Redmine has no trash, and the delete takes the issue's comments, time entries, attachments, and relations with it. It is annotateddestructiveHint: trueso an MCP client can require confirmation; if your client does not gate on that, treat every call as final.redmine_delete_issue_relationcarries the same annotation but is far narrower: it removes one link between two issues, andredmine_create_issue_relationputs it back in a single call.
Heads up:on write, Redmine silently ignores an unknowntracker_id,status_id, orfixed_version_idinstead of erroring — always check the returned issue. The same applies tois_private, which is silently dropped if your role lacks the "set public/private" permission.
The server runs locally and acts as a single user: yourREDMINE_API_KEYnever leaves your machine except as a request header to your own Redmine instance, and the server can do nothing your account couldn't already do. Multi-user HTTP transport is planned but not yet implemented — selectingMCP_TRANSPORT=httpexits with a clear error.
Local file access is off by default and confined toREDMINE_ALLOWED_DIRECTORIESwhen you enable it. Nothing else in the server reads or writes your filesystem.
- docs/architecture.md— design and request lifecycle
- docs/tools.md— generated per-tool reference
- docs/adding-a-tool.md— recipe for adding a new tool
- CONTRIBUTING.md— dev setup and contribution guide
npm install # install dependencies npm run dev # watch-run the stdio server npm test # run the test suite npm run build # bundle to dist/
The 1Password MCP server creates a bridge that allows MCP clients such as Codex and Kiro to manage your 1Password Environments with secure authorization prompts.
This is the 1st, easiest, and cheapest PPT, slides, presentation AI generation MCP Server in the world.
Persistent memory for any AI assistant. Zero token cost until recall. Stores memories in local SQLite, ranks by 6-factor scoring, returns results 79% smaller than JSON. Works with Claude, ChatGPT, Grok, Cursor, Windsurf, and any MCP client.
A MCP server that enables AI assistants to interact with Anki, the spaced repetition flashcard application.
Enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.
An MCP server for WordPress plugin audits
Turn your AI assistant into a digital marketing hub that creates, organizes, and analyzes links and QR Codes on demand.
Connect AI clients to Cal.com scheduling through the Model Context Protocol using the hosted server at mcp.cal.com or a local instance.
Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



