io.github.LeoMbm/malt-mcp
MCP server for Malt.fr. Read your freelance profile, stats, and missions from Claude.
Open source Open in the app JSON README (API)
About
MCP server for Malt.fr. Read your freelance profile, stats, and missions from Claude.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- leombm
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.3.1
- Stars
- 2
- Last push
- 2026-04-29T20:20:01Z
- Repository state
- ativo
- Language
- Python
- License
- Apache-2.0
- Added
- 2026-08-29 03:02:01
- Updated
- 2026-08-29 03:02:01
- Origin id
io.github.LeoMbm/malt-mcp
README
<!-- mcp-name: io.github.LeoMbm/malt-mcp -->
# Malt MCP Server
[](https://pypi.org/project/malt-mcp/)
[](https://python.org)
[](LICENSE)
MCP server for [Malt.fr](https://www.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)
<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](https://claude.ai/download).
**One-click installation:**
1. Download the latest `.mcpb` from [releases](https://github.com/LeoMbm/malt-mcp/releases/latest)
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](https://docs.astral.sh/uv/getting-started/installation/) 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](https://github.com/Kaliiiiiiiiii-Vinyzu/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.
```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](LICENSE)