@projora/mcp-server

A Model Context Protocol (MCP) server for Projora task management. Integrates with Claude Code and OpenCode to manage tasks directly from your AI coding assistant.

Features

• start_task - Start working on a task (sets status to "In Progress", adds comment, returns full context)
• complete_task - Mark a task as done with an optional summary
• get_task - Get a specific task by its key (e.g., "PRJ-123")
• list_projects - List all projects
• list_tasks - List tasks with optional filters (project, status, priority, assignee)
• my_tasks - Get tasks assigned to you
• overdue_tasks - Get all overdue tasks
• search_tasks - Search for tasks and projects by keyword
• update_task - Update task fields (title, description, priority, assignee, due date)
• update_task_status - Update task status
• add_comment - Add a comment to a task
• log_time - Log time worked on a task
• get_project - Get project details including linked GitHub repository
• get_config - Get available statuses, priorities, and task types
• dashboard_stats - Get dashboard statistics

Installation

npx @projora/mcp-server

Or install globally:

npm install -g @projora/mcp-server

Configuration

The server requires two environment variables:

• PROJORA_GRAPHQL_URL - Your Projora GraphQL endpoint (defaults to https://api.projora.app/graphql)
• PROJORA_AUTH_TOKEN - Your API token from Projora

Get your API token from Settings > Integrations in the Projora web app.

Usage with Claude Code

Add to your Claude Code configuration (~/.claude.json):

{
  "projora": {
    "command": "npx",
    "args": ["-y", "@projora/mcp-server"],
    "env": {
      "PROJORA_AUTH_TOKEN": "your-api-token"
    }
  }
}

Usage with OpenCode

Add to your OpenCode configuration (opencode.json):

{
  "mcp": {
    "projora": {
      "type": "local",
      "command": ["npx", "-y", "@projora/mcp-server"],
      "enabled": true,
      "environment": {
        "PROJORA_AUTH_TOKEN": "your-api-token"
      }
    }
  }
}

Note: PROJORA_GRAPHQL_URL defaults to https://api.projora.app/graphql. Only set it if you're using a self-hosted instance.

Example Prompts

Once configured, use prompts like:

• "Start working on task PRJ-123"
• "Show me my tasks"
• "What are the overdue tasks?"
• "Search for tasks related to authentication"
• "Mark task PRJ-123 as done with summary: Fixed the login bug"
• "Add a comment to PRJ-123: Need to review the test coverage"
• "Log 2 hours on task PRJ-123"

Workflow Example

1. Start a task: "Use projora to start working on task PRJ-123"

   • Status automatically changes to "In Progress"
   • A comment is added noting work has started
   • You get the full task context including description, GitHub repo, and suggested branch name

2. Work on the task: Make your changes, commit code, etc.

3. Complete the task: "Use projora to complete task PRJ-123 with summary: Implemented the new feature with tests"

   • Status changes to "Done"
   • A completion comment is added with your summary

Development

# Clone the repo
git clone https://github.com/projora/projora.git
cd projora/mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally
PROJORA_GRAPHQL_URL=http://localhost:8000/graphql PROJORA_AUTH_TOKEN=your-token npm start

License

MIT

Links

• Projora
• Documentation
• GitHub