What credentials are needed?
You need either `BLACKBIRD_CLIENT_KEY` and `BLACKBIRD_SECRET_KEY`, or `BLACKBIRD_USERNAME` and `BLACKBIRD_PASSWORD`. These are set as environment variables in the server configuration.
@blackbirdai-team
Basic information
Blackbird MCP Server
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"blackbird-mcp-server": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"--with",
"backoff",
"mcp",
"run",
"<PATH-TO-REPO>/blackbird-mcp-server/server.py"
],
"env": {
"BLACKBIRD_CLIENT_KEY": "",
"BLACKBIRD_SECRET_KEY": "",
"BLACKBIRD_USERNAME": "",
"BLACKBIRD_PASSWORD": ""
}
}
}
}Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
It is an MCP server that connects AI assistants like Claude Desktop and Cursor with the Blackbird AI platform using API credentials. It is for developers and users who want to access Blackbird’s capabilities through an MCP-enabled client.
Clone the repository, install uv and git, then add the server configuration to claude_desktop_config.json (Claude Desktop) or the MCP Servers settings (Cursor, v0.45.6+). Provide your Blackbird credentials (either BLACKBIRD_CLIENT_KEY and BLACKBIRD_SECRET_KEY or BLACKBIRD_USERNAME and BLACKBIRD_PASSWORD) as environment variables.
uv with the mcp and backoff packages.You need either `BLACKBIRD_CLIENT_KEY` and `BLACKBIRD_SECRET_KEY`, or `BLACKBIRD_USERNAME` and `BLACKBIRD_PASSWORD`. These are set as environment variables in the server configuration.
You need `uv` (install from astral.sh), `git` (for cloning), and either Claude Desktop or Cursor (v0.45.6+ for Cursor). The server itself uses `mcp[cli]` and `backoff` Python packages, which are handled by `uv run`.
Edit `claude_desktop_config.json` (located in `~/Library/Application Support/Claude/` on macOS or `%APPDATA%\Claude\` on Windows) by adding the `blackbird-mcp-server` entry with the `uv` command and your credentials.
Yes. Open Cursor Settings, go to Features > MCP Servers, add a new server with the same JSON configuration as for Claude Desktop.
The README does not specify; data handling depends on the Blackbird API that the server communicates with. Credentials are passed as environment variables and are not stored locally by the server.
🚀 The fast, Pythonic way to build MCP servers and clients.

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.
Painless E2E Automation for Mobile and Web

Model Context Protocol Servers
YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context
Comments