stayhomer.png

Treat without the trick!

Be brave and face your Redmine fears Horribly awesome discounts wait for you!

Halloween special offer has begun!

Getting started with Agent plugin

Redmine Agent adds an AI assistant to Redmine. It drafts issue comments and descriptions, summarizes issues, wiki pages, forum topics and versions, and exposes Redmine to external AI clients (Claude, ChatGPT, Cursor, Codex, Gemini CLI) through an MCP server. Everything runs inside Redmine under the permissions of the current user: no Redis, no worker, no cron.

Setup in four steps

  1. Install the plugin and restart Redmine.
  2. As administrator, connect an AI model and select it as the active one.
  3. Enable the Agent module in the projects where it should work (Project settings → Modules) and give the Use Agent permission to the roles.
  4. Optional: enable the MCP server to work with Redmine from external AI clients.

What you get

Feature Where it appears Article
AI assistant for comments and descriptions Agent button in the Notes and Description toolbars AI assistant in issue comments and descriptions
AI summaries "AI summary" item in the actions menu of an issue, wiki page, forum topic or version AI summaries
Instructions Project settings → Agent, My account → AI Instructions AI instructions
MCP server https://your-redmine.example.com/mcp MCP server, MCP tools reference
Usage statistics (PRO) Administration → Plugins → Redmine Agent Usage statistics

Light and PRO

Light includes the AI assistant for comments and descriptions, shared summaries, instructions, the MCP server, attachment reading and the extension API. PRO adds personal summaries, OAuth sign-in with a ChatGPT subscription, the usage statistics page and the wiki and web tools of the assistant.

Key principles

  • The AI never sees more than the user: issues, private notes, wiki pages and attachments are filtered by Redmine permissions before they reach the model.
  • The built-in AI assistant never writes to Redmine by itself. A draft is inserted into the form and you review and save it. Writing is possible only through the MCP server, on behalf of the user and with the user's rights.
  • Text of issues, wiki pages and web pages is treated as data, never as instructions for the model.
Was this article helpful? Yes  No