DocketBird MCP Server

by gravix-db

1 226 downloads Not rated yet Apache-2.0

GitHub

Other

About

DocketBird MCP Server is an MCP server that provides access to DocketBird’s court case data and document management functionality. It is intended for developers and legal professionals who need to query case information, download documents, and manage court data through the…

Details

License: Apache-2.0

Explore

- Interactive command-line interface
- Natural language querying for case information
- Connects to the deployed DocketBird MCP server

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name DocketBird MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

From the repository

- Python 3.11
- uv package manager

Run the server using:

uv run docketbird_mcp.py --transport stdio  # For stdio transport
uv run docketbird_mcp.py --transport sse    # For SSE transport

Make sure these files are in the same directory as the script:

- courts.json: Contains information about all available courts
- case_types.json: Contains information about different types of cases

The MCP server configuration can be added to one of these locations depending on your MCP client:

- Cursor: ~/.cursor/mcp.json
- Claude in mac: ~/Library/Application Support/Claude/claude_desktop_config.json

How to open Claude Desktop config file from app

- Launch Claude Desktop application - Navigate to the application menu and select Settings - Select Developer from the left navigation panel - Click the Edit Config button - Your system will automatically open the configuration file in your default text editor

1. Install uv if you haven't already:

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

Add the following configuration to the appropriate file:

_For macOS:_

{
  "mcpServers": {
    "docketbird-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "PATH_TO_THE_SERVER/docketbird-mcp",
        "python",
        "docketbird_mcp.py"
      ],
      "env": {
        "DOCKETBIRD_API_KEY": "YOUR_KEY"
      }
    }
  }
}

_For Windows:_

{
  "mcpServers": {
    "docketbird-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "PATH_TO_SERVER\\docketbird-mcp",
        "python",
        "docketbird_mcp.py"
      ],
      "env": {
        "DOCKETBIRD_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Be sure to replace:

- PATH_TO_THE_SERVER with the actual path to where you cloned the DocketBird MCP repository (for macOS)
- PATH_TO_SERVER with the actual path to where you cloned the DocketBird MCP repository (for Windows)
- YOUR_KEY with your actual DocketBird API key

The DocketBird MCP server can be deployed to a cloud server using Docker and GitHub Actions. The deployment process is defined in the .github/workflows/deploy.yml file.

The server is containerized using Docker. You can build and run the Docker image locally with the desired transport type:

To validate that your deployment is working correctly: 1. Check that the container is running:

bash
docker ps | grep docketbird-mcp

2. Verify the container logs:

bash
docker logs docketbird-mcp

The logs should show:

Starting DocketBird MCP server...
API Key set: your_...
Running python docketbird_mcp.py

3. Test the connection from your MCP client using the configuration from this README. If the container isn't running, you can troubleshoot by checking: - Docker image exists: docker images | grep docketbird - Container logs for errors: docker logs docketbird-mcp - Server logs: Check if there are any permission or network issues 1. Ensure you have the OpenAI API key set as an environment variable:

bash
export OPENAI_API_KEY=your_openai_api_key_here # On Unix/MacOS

The server provides the following tools:

1. get_case_details: Get comprehensive details about a case including all documents
2. download_document_by_id: Download a specific document by its DocketBird ID
3. list_cases: Get a list of cases belonging to an account
4. list_courts_and_types: Get a comprehensive list of all available courts and case types

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "docketbird mcp server": {
            "docketbird-mcp": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "docketbird-mcp": {
        "command": "uv",
        "args": [
            "venv"
        ]
    }
}

This MCP server provides access to DocketBird's court case data and document management functionality.

Requirements

- Python 3.11
- uv package manager

Setup

1. Install uv if you haven't already:

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

2. Create and activate a virtual environment:

```bash
uv venv
source .venv/bin/activate # On Unix/MacOS

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Requirements

Setup

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive