The AMRIT OpenProject MCP Server enables AI assistants to securely access OpenProject using your own credentials.
Once connected, the AI assistant can:
Search projects
View work packages
Track project progress
Review assigned work
Monitor project status
Analyze schedules and timelines
Generate project summaries
Create and update work packages
Retrieve project information using natural language
Before connecting your AI assistant, ensure you have:
Access to OpenProject
An OpenProject API Token
An MCP-compatible AI client (Claude Desktop, Claude Code, Cursor, etc.)
Log in to OpenProject.
Click your profile avatar in the upper-right corner.
Open My Account.
Navigate to Access Tokens or API Tokens.
Generate a new API token.
Copy and securely store the token.
Important: Treat this token like a password. Do not share it with anyone.
Use the following AMRIT OpenProject MCP endpoint:
https://amrittools.piramalswasthya.org/openproject/mcp
To configure MCP servers, you need to edit the Claude Desktop configuration file.
Open File Explorer and navigate to:
%APPDATA%\Claude\claude_desktop_config.json
Or directly:
C:\Users\<YourUsername>\AppData\Roaming\Claude\claude_desktop_config.json
Navigate to:
~/Library/Application Support/Claude/claude_desktop_config.json
Navigate to:
~/.config/Claude/claude_desktop_config.json
Add the following MCP configuration to your AI client:
{
"mcpServers": {
"openproject-mcp": {
"type": "http",
"url": "https://amrittools.piramalswasthya.org/openproject/mcp",
"headers": {
"Authorization": "Bearer <YOUR_OPENPROJECT_API_TOKEN>"
}
}
}
}
If you are using Claude Desktop, use the configuration below.
Open the Claude Desktop configuration file and add the following configuration inside the existing mcpServers section:
{
"mcpServers": {
"mcp-openproject": {
"command": "npx.cmd",
"args": [
"-y",
"mcp-remote",
"https://amrittools.piramalswasthya.org/openproject/mcp",
"--header",
"Authorization: Bearer <YOUR_OPENPROJECT_API_TOKEN>"
]
}
}
}
Replace:
<YOUR_OPENPROJECT_API_TOKEN>
with the API token generated from OpenProject.(Bearer must be present)
After updating the configuration:
Completely close Claude Desktop.
Ensure Claude Desktop is not running in the system tray or Task Manager.
Reopen Claude Desktop.
After restarting your AI client, try asking:
Show all OpenProject projects available to me.
or
List my assigned OpenProject work packages.
If project information is returned successfully, the connection has been configured correctly.
The OpenProject MCP Server allows AI assistants to interact directly with OpenProject projects, work packages, schedules, time tracking, project memberships, dependencies, and reporting information.
Users can query project data, manage work items, monitor delivery progress, and generate project insights using natural language.
The MCP Server can help users manage projects throughout their lifecycle.
View project details
List active projects
Create new projects
Update project information
Archive or remove projects
Review project metadata
Track project status
Project Managers
Review all active projects
Monitor project health
Create new project workspaces
Track delivery progress
Delivery Managers
Review project portfolios
Identify projects at risk
Analyze project timelines
Work Packages are the core planning and execution units within OpenProject.
View work package details
Search work packages
Create new work packages
Update existing work packages
Delete work packages
Assign work packages
Change status
Update completion percentage
Manage priorities
Business Analysts
Review assigned requirements
Track implementation progress
Create new analysis tasks
Project Managers
Monitor project execution
Reassign work when required
Review task completion status
Developers and Team Leads
Update task progress
Manage implementation activities
Track work completion
The MCP Server provides advanced filtering capabilities for finding work packages.
Find overdue tasks
Find high-priority tasks
Find unassigned tasks
Find tasks due soon
Find recently created tasks
Find nearly completed tasks
Filter by assignee
Filter by project
Filter by status
Filter by priority
Filter by completion percentage
Scrum Masters
Identify sprint risks
Review overdue work
Monitor pending assignments
Project Managers
Track upcoming deadlines
Review critical issues
Identify bottlenecks
Delivery Managers
Review project health
Monitor execution risk
The MCP Server can provide visibility into project teams and memberships.
View project members
View user assignments
View project memberships
View user roles
Assign users to projects
Update project memberships
Remove project memberships
Project Managers
Review team composition
Validate resource allocation
Onboard project members
Delivery Managers
Analyze team distribution
Review project ownership
The MCP Server supports OpenProject time tracking functionality.
View logged time
Create time entries
Update time entries
Delete time entries
Review effort spent
View activity categories
Team Members
Log work effort
Update work records
Project Managers
Review effort consumption
Compare planned vs actual effort
Delivery Managers
Analyze project utilization
Review resource consumption
The MCP Server provides access to project versions and milestones.
View project milestones
Create milestones
Update milestone schedules
Review release timelines
Monitor milestone progress
Product Owners
Review roadmap progress
Track planned releases
Project Managers
Monitor milestone completion
Manage release schedules
The MCP Server can manage dependencies between work packages.
Create parent-child relationships
View child work packages
Remove hierarchy relationships
Create task dependencies
View dependency chains
Update dependency relationships
Remove dependency relationships
Blocks
Follows
Precedes
Relates To
Duplicates
Includes
Requires
Part Of
Project Managers
Identify blockers
Manage dependency chains
Analyze delivery risks
Scrum Masters
Remove execution bottlenecks
Track blocked work
Delivery Managers
Monitor cross-team dependencies
Assess project impact
The MCP Server can help generate project insights from OpenProject data.
Identify overdue work
Track completion trends
Review project workload
Analyze team assignments
Review milestone progress
Generate project summaries
Identify delivery risks
Leadership Teams
Portfolio reviews
Delivery monitoring
Risk assessment
Project Managers
Weekly status reporting
Progress reviews
Sprint planning
Business Analysts
Requirement tracking
Feature delivery monitoring
All OpenProject operations are performed using the user's own API token.
Users can only access:
Projects they are authorized to view
Work packages they have permission to access
Team information available to their role
Time entries available within their permissions
The MCP server does not grant any additional permissions beyond those already assigned within OpenProject.
Verify:
The OpenProject API token is valid.
The token has not expired.
The token was copied correctly.
The Authorization header includes the Bearer prefix.
Verify:
You have permission to access the project.
The work package exists.
Your account permissions are sufficient.
Verify:
The MCP endpoint URL is correct.
Your network connection is available.
Your AI client supports MCP connections.
The OpenProject MCP Server can be used from:
Claude Desktop
Claude Code
Cursor
Other MCP-compatible AI clients
For issues related to MCP connectivity or access, contact the AMRIT Agentic AI Framework team and provide:
AI client being used
Error message received
Project involved
Steps performed before the issue occurred