Malt MCP Server

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

Malt MCP Server demo

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:

Download the latest .mcpb from releases
Double-click the .mcpb file to install it into Claude Desktop
Ask Claude "connecte-moi a Malt" - a browser opens, you log in, done
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

malt-mcp

Quick Install