Peil-mcp

ConnectPeilto Claude (or any MCP client): log hours, draft invoices from unbilled hours, and check where you stand — from a prompt.

- Website:https://peil.app
- Docs:https://peil.app/en/docs/mcp
- Source:https://github.com/Luminc/peil-mcp

uvx peil-mcp # runs the latest release on demand # or, with pipx: pipx run peil-mcp

→ Your launch command isuvx peil-mcp(orpipx run peil-mcp). Skip tostep 3. Everything below is only needed if you're runningfrom source(e.g. before the first release, or to hack on it).

uv run --directory /ABS/PATH/TO/mcp-server peil-mcp

cd /ABS/PATH/TO/mcp-server python3 -m venv .venv .venv/bin/pip install .

Use aplainpip install .(not-e/editable) for running. An editable install relies on a.pthpath hook that can silently fail to load on some setups, givingModuleNotFoundError: No module named 'peil_mcp'. Editable is only needed if you're modifying the server itself — seeLocal development.

- command— your launch command from step 2
- env—PEIL_API_KEYset to the key from step 1
- (optional)PEIL_API_URL— only if you're pointing at a non-production Peil (seeLocal development); defaults tohttps://api.peil.app/api/v1.

{ "mcpServers": { "peil": { "command": "peil-mcp", // or "uv", or the venv's python path "args": [], // e.g. ["run","--directory","/ABS/PATH/TO/mcp-server","peil-mcp"] for uv "env": { "PEIL_API_KEY": "your-key" } } } }

Editclaude_desktop_config.json(macOS:~/Library/Application Support/Claude/, Windows:%APPDATA%\Claude\), add the block above, and restart Claude Desktop.

# pipx / venv (single-command launcher): claude mcp add peil -e PEIL_API_KEY=your-key -- peil-mcp # uv: claude mcp add peil -e PEIL_API_KEY=your-key -- uv run --directory /ABS/PATH/TO/mcp-server peil-mcp

Anything after--is the launch command. Verify withclaude mcp get peil(look forStatus: ✔ Connected) and use/mcpin a session to reconnect.

Add the canonical block to.cursor/mcp.json(this project) or~/.cursor/mcp.json(all projects), then enablepeilinSettings → MCP.

Add the canonical block to~/.codeium/windsurf/mcp_config.json, then hitRefreshin the Cascade MCP panel.

Open the extension'sMCP Servers → Configurepanel and add the canonical block tocline_mcp_settings.json.

VS Code uses a slightly different shape —servers(notmcpServers) and an explicittype— in.vscode/mcp.json:

{ "servers": { "peil": { "type": "stdio", "command": "peil-mcp", "args": [], "env": { "PEIL_API_KEY": "your-key" } } } }

Give it the samecommand + args +PEIL_API_KEYenv. The server speaks MCP over stdio; if a client can launch a stdio command, it can run Peil.

- "Where do I stand?"→orientation_snapshot
- "Log 6 hours to De Correspondent today for editing work."→log_hours
- "Draft an invoice from my unbilled hours for De Correspondent."→draft_invoice

WithSend invoicesleft off your key, an assistant can prepare everything but physically cannot email a client — you send from Peil yourself.

Point the server at a local backend withPEIL_API_URL:

PEIL_API_URL=http://localhost:8000/api/v1 PEIL_API_KEY=your-local-key peil-mcp

If you're modifying the server, an editable install picks up your changes without reinstalling:

.venv/bin/pip install -e ".[dev]"

Tests (mocked HTTP, no backend needed —pythonpath = ["src"]inpyproject.tomlmakes them independent of the install mechanism):

Multi-device file sync, dev-doc CRUD, task management, and session handoffs for AI agents - MCP + OpenAPI dual surface.

Shared workspace your AI agents write to — 184+ MCP tools for CMMN case management.

An MCP server for integrating with Clio practice management software, tailored for Australian legal professionals.

FoundersOS - CRM, tasks, finances, feeds, and memory for founders, as an MCP server.

Freelance business manager — clients, proposals, invoices, time tracking, scope, and follow-ups. 37 MCP tools.

Create professional PDF invoices using natural language.

A server that enables access to Joplin notes and to-dos through the Model Context Protocol (MCP).

Manage your job search directly. List jobs, create applications, add events, run company research, generate templates, and more.

Connect your AI assistant to your personal knowledge base. Search, save links, create notes and to-dos. AI processes everything automatically.

Interact with Notion's API to read, create, and modify content using natural language.