Malt Mcp

Malt MCP Server

[](https://pypi.org/project/malt-mcp/) [](https://python.org) [](LICENSE)

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

[](#-claude-desktop-mcp-bundle) [](#-uvx-setup-universal) [](#docker-coming-soon)

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](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](LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: LeoMbm
• Source: LeoMbm/malt-mcp
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.