DevRev MCP server for AI agents

This MCP server for DevRev provides a powerful interface to DevRev's APIs, allowing you to manage work items, parts, meetings, and more through Claude's AI interface.

Installation

Before using the DevRev MCP server, you need to install either uvx or uv, which are modern Python package management tools.

Installing uv

On macOS and Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

On Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Alternative Installation Methods:

With Homebrew (macOS):

brew install uv

Using pip:

pip install uv

Verifying Installation

Confirm that uv and uvx are available:

# Check uv version
uv --version

# Check uvx version  
uvx --version

If you encounter "command not found" errors, try restarting your terminal or adding the installation directory to your PATH.

Setting Up DevRev API Access

Create a DevRev account at https://app.devrev.ai/signup
Import your data from existing sources like Salesforce or Zendesk by following the instructions at https://devrev.ai/docs/import#available-sources
Generate an access token by following the instructions at https://developer.devrev.ai/public/about/authentication#personal-access-token-usage

Configuring with Claude Desktop

Configuration Location

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

For Published Servers

Add this to your Claude Desktop configuration:

"mcpServers": {
  "devrev": {
    "command": "uvx",
    "args": [
      "devrev-mcp"
    ],
    "env": {
      "DEVREV_API_KEY": "YOUR_DEVREV_API_KEY"
    }
  }
}

For Development/Unpublished Servers

"mcpServers": {
  "devrev": {
    "command": "uv",
    "args": [
      "--directory",
      "Path to src/devrev_mcp directory",
      "run",
      "devrev-mcp"
    ],
    "env": {
      "DEVREV_API_KEY": "YOUR_DEVREV_API_KEY"
    }
  }
}

Using the DevRev MCP Server

Once configured, you can use Claude to interact with your DevRev data through natural language requests. Here are some examples of what you can do:

Search and Discovery

Search across your DevRev data:

Search for all open tickets related to the authentication feature

Get current user information:
```
Show me my user information in DevRev
```

Retrieve vista board information:

Get details about the sprint board with ID [vista_id]

Work Item Management

Create new issues or tickets:

Create a new issue titled "Login page not responsive on mobile" assigned to John

Update existing work items:

Update ticket ID-123 to change its status to "In Progress" and assign it to Sarah

List and filter work items:

Show me all critical issues created in the last week

Parts (Enhancements) Management

Create new enhancements:

Create a new enhancement called "User Authentication Flow" with description "Implement OAuth2 flow for user authentication"

Update existing parts:

Update the enhancement PART-456 to target completion by end of Q3

List and filter parts:

List all enhancements assigned to the Backend team

Workflow Management

Check valid stage transitions:

What are the valid stage transitions for work item ISSUE-789?

Add timeline entries:

Add a comment to ticket TICKET-123 saying "Fixed the CSS issue, ready for review"

Get sprint information:

Show me the active sprints for the "User Authentication" part

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "devrev" '{"command":"uvx","args":["devrev-mcp"],"env":{"DEVREV_API_KEY":"YOUR_DEVREV_API_KEY"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "devrev": {
            "command": "uvx",
            "args": [
                "devrev-mcp"
            ],
            "env": {
                "DEVREV_API_KEY": "YOUR_DEVREV_API_KEY"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "devrev": {
            "command": "uvx",
            "args": [
                "devrev-mcp"
            ],
            "env": {
                "DEVREV_API_KEY": "YOUR_DEVREV_API_KEY"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect