io.github.LeoMbm/malt-mcp

Official

by LeoMbm · Python

MCP server for Malt.fr. Read your freelance profile, stats, and missions from Claude.

Malt MCP Server is an MCP server for Malt.fr that lets an MCP client read a user’s freelance data. Its description indicates access to a freelance profile, stats, and missions, typically for Claude or other MCP-compatible tools.

🛠️ Key Features

MCP server for Malt.fr
Reads freelance profile information
Reads freelance stats
Reads freelance missions

🚀 Use Cases

Connect an MCP client (including Claude) to view Malt.fr freelance profile details
Retrieve mission listings and related stats through MCP

⚡ Developer Benefits

Designed for MCP clients to consume Malt.fr data
Python-focused project (Python 3.12+ indicated)

⚠️ Limitations

Scope is limited to reading Malt.fr freelance profile, stats, and missions (no other capabilities mentioned)

README.md5 KBView on GitHub

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):

json

{
  "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:

bash

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.

bash

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):

bash

uv run mcp dev malt_mcp_server/server.py

Run tests:

bash

uv run pytest --cov -v

Type check:

bash

uv run ty check

License

Apache 2.0

Install

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "malt-mcp": {
      "command": "uvx",
      "args": [
        "malt-mcp"
      ]
    }
  }
}

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Malt MCP Server

Tools

📦 Claude Desktop MCP Bundle

🚀 uvx Setup (Universal)

Docker (coming soon)

⚙️ CLI Options

❗ Troubleshooting

🔒 How it works

🐍 Development

License

Install

Related servers