MCP server for OpenProject: 89 tools for work packages, attachments, git activity, meetings, time tracking and reporting over API v3
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add openproject --env OPENPROJECT_URL='<OPENPROJECT_URL>' --env OPENPROJECT_API_KEY='<OPENPROJECT_API_KEY>' --env OPENPROJECT_OAUTH_TOKEN='<OPENPROJECT_OAUTH_TOKEN>' -- uvx openproject-mcp-server~/.codex/config.toml
[mcp_servers.openproject]
command = "uvx"
args = ["openproject-mcp-server"]
env = { OPENPROJECT_URL = "<OPENPROJECT_URL>", OPENPROJECT_API_KEY = "<OPENPROJECT_API_KEY>", OPENPROJECT_OAUTH_TOKEN = "<OPENPROJECT_OAUTH_TOKEN>" }
# codex mcp add openproject --env OPENPROJECT_URL='<OPENPROJECT_URL>' --env OPENPROJECT_API_KEY='<OPENPROJECT_API_KEY>' --env OPENPROJECT_OAUTH_TOKEN='<OPENPROJECT_OAUTH_TOKEN>' -- uvx openproject-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"openproject": {
"command": "uvx",
"args": [
"openproject-mcp-server"
],
"env": {
"OPENPROJECT_URL": "<OPENPROJECT_URL>",
"OPENPROJECT_API_KEY": "<OPENPROJECT_API_KEY>",
"OPENPROJECT_OAUTH_TOKEN": "<OPENPROJECT_OAUTH_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"openproject": {
"type": "stdio",
"command": "uvx",
"args": [
"openproject-mcp-server"
],
"env": {
"OPENPROJECT_URL": "<OPENPROJECT_URL>",
"OPENPROJECT_API_KEY": "<OPENPROJECT_API_KEY>",
"OPENPROJECT_OAUTH_TOKEN": "<OPENPROJECT_OAUTH_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"openproject": {
"command": "uvx",
"args": [
"openproject-mcp-server"
],
"env": {
"OPENPROJECT_URL": "<OPENPROJECT_URL>",
"OPENPROJECT_API_KEY": "<OPENPROJECT_API_KEY>",
"OPENPROJECT_OAUTH_TOKEN": "<OPENPROJECT_OAUTH_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"openproject": {
"command": "uvx",
"args": [
"openproject-mcp-server"
],
"env": {
"OPENPROJECT_URL": "<OPENPROJECT_URL>",
"OPENPROJECT_API_KEY": "<OPENPROJECT_API_KEY>",
"OPENPROJECT_OAUTH_TOKEN": "<OPENPROJECT_OAUTH_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"openproject": {
"command": "uvx",
"args": [
"openproject-mcp-server"
],
"env": {
"OPENPROJECT_URL": "<OPENPROJECT_URL>",
"OPENPROJECT_API_KEY": "<OPENPROJECT_API_KEY>",
"OPENPROJECT_OAUTH_TOKEN": "<OPENPROJECT_OAUTH_TOKEN>"
}
}
}
}Environment variables
OPENPROJECT_URLOPENPROJECT_API_KEYOPENPROJECT_OAUTH_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.