malt-mcp

<!-- mcp-name: io.github.LeoMbm/malt-mcp -->

Malt MCP Server

  

MCP server for Malt.fr. Lets Claude (or any MCP client) read your freelance profile, stats, and missions.

  

<p align="center"> <img src="assets/malt-demo.gif" alt="Malt MCP Server demo" width="800"> </p>

Tools

| Tool | Description | Status | |------|-------------|--------| | authenticate | Log in to Malt interactively from Claude Desktop | working | | get_profile | Get freelance profile info (bio, daily rate, skills, rating). Omit username to fetch your own profile. | working | | get_statistics | View profile stats (views, response rate, missions) | working | | get_missions | List mission conversations from messaging | working | | get_mission_details | Get full details of a specific mission (budget, skills, messages) | working | | close_session | Close the browser and free resources | working |

📦 Claude Desktop MCP Bundle

Prerequisites: Claude Desktop.

One-click installation:

1. Download the latest .mcpb from releases
2. Double-click the .mcpb file to install it into Claude Desktop
3. Ask Claude "connecte-moi a Malt" - a browser opens, you log in, done
4. Call any Malt tool

No terminal needed. Session is saved in ~/.malt-mcp/ and reused across restarts.

[!NOTE] Google OAuth doesn't work (blocked by Google when automated). Use email/password.

🚀 uvx Setup (Universal)

Prerequisites: uv installed.

Add to your MCP client config (Claude Desktop, Claude Code, or any MCP-compatible client):

{
  "mcpServers": {
    "malt": {
      "command": "uvx",
      "args": ["malt-mcp@latest"],
      "env": { "UV_HTTP_TIMEOUT": "300" }
    }
  }
}

@latest pulls the newest version from PyPI on each launch. First auth-requiring call opens a browser for login.

To log in ahead of time:

uvx malt-mcp@latest --login

Docker (coming soon)

⚙️ CLI Options

| Option | Description | |--------|-------------| | --login | Open browser to log in and save session | | --logout | Clear stored browser profile | | --no-headless | Show browser window (debug) | | --log-level | Set log level (DEBUG, INFO, WARNING, ERROR) | | --timeout | Browser timeout in ms (default: 5000) |

❗ Troubleshooting

Login issues:

• Google OAuth won't work. Use email/password.
• Session expired? Re-run uvx malt-mcp@latest --login.
• Cloudflare challenge on first load is normal - the browser handles it, give it a few seconds.

Timeout issues:

• Pages not loading? Try --timeout 10000. Slow connections might need 15000.

Browser issues:

• Headless mode doesn't work - Cloudflare blocks it. The browser window is expected.
• First run downloads Chromium (~200 MB via Patchright). One-time thing.
• Upgrading from v0.3.x? Run uvx malt-mcp@latest --logout then --login. The browser engine changed from system Chrome to managed Chromium.

🔒 How it works

Under the hood, this is browser automation via Patchright (Playwright fork). No API, no reverse-engineering - it drives a real browser like you would.

• Credentials stay local. Cookies live in ~/.malt-mcp/profile/, nowhere else.
• Read-only. Nothing is modified on your Malt account (for now).
• Runs locally. The server talks to Malt.fr and nothing else.

[!IMPORTANT] Malt's TOS may prohibit automated tools. Don't bulk-scrape. Use responsibly.

🐍 Development

Contributions welcome! See CONTRIBUTING.md for architecture guidelines.

git clone https://github.com/LeoMbm/malt-mcp.git
cd malt-mcp
uv sync --group dev
pre-commit install

Run the MCP Inspector (local testing):

uv run mcp dev malt_mcp_server/server.py

Run tests:

uv run pytest --cov -v

Type check:

uv run ty check

License

Apache 2.0