What is io.github.LeoMbm/malt-mcp?

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

How do I install io.github.LeoMbm/malt-mcp?

Clone io.github.LeoMbm/malt-mcp from https://github.com/LeoMbm/malt-mcp and configure it as an MCP server in your client (Claude Desktop, Cursor, or VS Code).

Is io.github.LeoMbm/malt-mcp open source?

Yes, io.github.LeoMbm/malt-mcp is open source under the Apache-2.0 license. Source code is available at https://github.com/LeoMbm/malt-mcp.

What category does io.github.LeoMbm/malt-mcp belong to?

io.github.LeoMbm/malt-mcp is listed under Developer Tools MCP servers on MCPFind.

io.github.LeoMbm/malt-mcp — MCP Server for Developer Tools

Malt MCP Server

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

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

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

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

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

io.github.LeoMbm/malt-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

io.github.LeoMbm/malt-mcp