# ERPNext API and MCP server

**ChatGPT, Claude and other AI agents can work in your ERPNext account.** Cotlet.dev provides hosted MCP and REST access to your signed-in ERPNext Cloud Browser.

## What you can ask

> Read customers and invoices.

> Record a customer payment.

> Prepare a weekly overdue report.

## Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as `COTLET_API_KEY`.

### Claude Code

```bash
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
```

### ChatGPT

Settings -> Apps -> add connector URL `https://cotlet.dev/mcp/v1`, then sign in with Cotlet.dev. No API key needed.

### Cursor

Copy `.cursor/mcp.json` from this repo into your project.

## Run it locally (stdio)

This repo includes a small stdio MCP client that forwards calls to Cotlet.dev. Set `COTLET_API_KEY` before running it.

```bash
python3 erpnext_agent.py connect
python3 erpnext_agent.py status
python3 erpnext_agent.py guide
```

Tools: `erpnext_guide`, `erpnext_status`, `erpnext_open`, `erpnext_read`, `erpnext_click`, `erpnext_type`, `erpnext_close`.

## Questions from ERPNext users

**Does ERPNext have an API or MCP server?** The live ERPNext page documents Cotlet.dev MCP and REST access for your signed-in account.

**How does Cotlet.dev connect to ERPNext?** Sign in to ERPNext in your Cotlet Cloud Browser, then connect your agent over MCP or REST.

**What can an AI agent do?** It can read customers, invoices and other workflows available to your ERPNext account.

## Links

- [ERPNext on Cotlet.dev](https://cotlet.dev/integrations/erpnext-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=erpnext)
- [ERPNext MCP repositories](https://github.com/cotlet-connect)
- [Start free](https://cotlet.dev/signup?app=erpnext&utm_source=github&utm_medium=readme&utm_campaign=erpnext)