nocfo-cli 0.1.0__tar.gz

nocfo_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NoCFO
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nocfo_cli-0.1.0/PKG-INFO

@@ -0,0 +1,277 @@
+Metadata-Version: 2.4
+Name: nocfo-cli
+Version: 0.1.0
+Summary: NoCFO CLI, MCP server, and Cursor skill toolkit.
+License: MIT
+License-File: LICENSE
+Keywords: nocfo,cli,mcp,fastmcp,accounting,invoicing
+Author: NoCFO
+Requires-Python: >=3.10,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: fastmcp (>=2.0)
+Requires-Dist: httpx (>=0.27)
+Requires-Dist: python-dotenv (>=1.0)
+Requires-Dist: rich (>=13.0)
+Requires-Dist: typer (>=0.12)
+Project-URL: Documentation, https://api-prd.nocfo.io/docs
+Project-URL: Homepage, https://nocfo.io
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+<img src="assets/banner.svg" alt="NoCFO AI Toolkit" width="100%" />
+
+<br />
+
+### Give AI assistants full access to Finnish bookkeeping, invoicing, and business data.
+
+[![PyPI](https://img.shields.io/pypi/v/nocfo-cli?color=%230073E6&label=PyPI)](https://pypi.org/project/nocfo-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/nocfo-cli?color=%230073E6)](https://pypi.org/project/nocfo-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-%230073E6)](LICENSE)
+
+</div>
+
+Open-source Python toolkit that connects [NoCFO](https://nocfo.io) to your terminal and AI workflows — a single package powering a CLI client, an MCP server, and a Cursor AI skill.
+
+## Features
+
+- **All-in-one package** — CLI, MCP server, and Cursor skill from a single `pip install`
+- **60+ MCP tools** across 11 domains (businesses, accounts, invoices, contacts, documents, and more)
+- **OpenAPI-driven** — tools stay in sync with the live NoCFO API schema
+- **PAT authentication** — simple token-based auth with config file, env var, or CLI flag
+- **Dual output** — human-friendly tables for terminals, JSON for scripts and pipelines
+- **Claude Desktop + Cursor** — works as stdio MCP server or standalone CLI
+- **Zero-config run** — `uvx nocfo-cli --help` with no permanent install
+
+## Quick Install
+
+**pip** (recommended)
+
+```bash
+pip install nocfo-cli
+```
+
+**pipx** (isolated install)
+
+```bash
+pipx install nocfo-cli
+```
+
+**uvx** (no install needed)
+
+```bash
+uvx nocfo-cli --help
+```
+
+## Authentication
+
+Create a Personal Access Token at [login.nocfo.io/auth/tokens](https://login.nocfo.io/auth/tokens), then configure once:
+
+```bash
+nocfo auth configure --token <your_pat>
+nocfo auth status
+```
+
+Or pass via environment:
+
+```bash
+export NOCFO_API_TOKEN=<your_pat>
+```
+
+<details>
+<summary>Auth precedence & defaults</summary>
+
+| Priority | Source                            |
+| -------- | --------------------------------- |
+| 1        | `--api-token` CLI flag            |
+| 2        | `NOCFO_API_TOKEN` env var         |
+| 3        | `~/.config/nocfo-cli/config.json` |
+
+Default base URL: `https://api-prd.nocfo.io`
+Default output format: `table`
+
+</details>
+
+## Quick Start
+
+```bash
+nocfo user me                        # current user info
+nocfo businesses list                # list all businesses
+nocfo invoices list --business slug  # sales invoices
+nocfo documents list --business slug --query date_from=2026-01-01
+nocfo contacts create --business slug --field name=Acme
+```
+
+JSON output for automation:
+
+```bash
+nocfo --output json businesses list | jq '.results[]'
+```
+
+## Set Up with Claude Desktop (step-by-step)
+
+Connect NoCFO to Claude so you can ask questions about your bookkeeping in plain language. No coding experience needed.
+
+### 1. Install Python
+
+NoCFO AI Toolkit needs Python 3.10 or newer.
+
+**Mac** — open **Terminal** (search "Terminal" in Spotlight) and run:
+
+```bash
+brew install python
+```
+
+> Don't have Homebrew? Install it first: https://brew.sh
+
+**Windows** — download from https://www.python.org/downloads/ and run the installer. **Check the box** "Add Python to PATH" during install.
+
+Verify it works:
+
+```bash
+python3 --version
+```
+
+You should see `Python 3.10` or higher.
+
+### 2. Get your NoCFO token
+
+You need a Personal Access Token (PAT) so that Claude can read your NoCFO data on your behalf.
+
+1. Open [login.nocfo.io/auth/tokens](https://login.nocfo.io/auth/tokens/) in your browser
+2. **Log in** with your NoCFO account (Apple, Google, Microsoft, or email)
+3. After login, you'll see the **API-avaimet** (API keys) page
+4. Click **Luo uusi avain** ("Create new key")
+5. Give the token a name you'll recognise, e.g. `Claude Desktop`
+6. Click **Luo** ("Create")
+7. The token appears once — **copy it now** and save it somewhere safe (e.g. a password manager). You won't be able to see it again.
+
+> **Tip:** If you lose the token, you can always delete the old one and create a new one from the same page.
+
+### 3. Configure Claude Desktop
+
+1. Open **Claude Desktop**
+2. Go to **Settings → Developer → Edit Config** (or open the file manually — see paths below)
+3. Paste the following into the config file, replacing `your_token_here` with the token from step 2:
+
+```json
+{
+  "mcpServers": {
+    "nocfo": {
+      "command": "uvx",
+      "args": ["nocfo-cli", "mcp"],
+      "env": {
+        "NOCFO_API_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+> If the file already has other servers configured, add the `"nocfo": { ... }` block inside the existing `"mcpServers"` object.
+
+<details>
+<summary>Config file locations</summary>
+
+| OS      | Path                                                              |
+| ------- | ----------------------------------------------------------------- |
+| Mac     | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Windows | `%APPDATA%\Claude\claude_desktop_config.json`                     |
+
+</details>
+
+4. **Restart Claude Desktop**
+
+### 4. Try it out
+
+Open a new chat in Claude and ask:
+
+- _"Listaa yritykseni"_
+- _"Montako myyntilaskua on tällä kuussa?"_
+- _"Ketkä ovat suurimmat asiakkaani?"_
+
+Claude uses NoCFO tools automatically to answer. You'll see a tool icon when it accesses your data.
+
+---
+
+## Set Up with Cursor
+
+Add the same config to Cursor's MCP settings (**Settings → MCP → Add Server**) using `nocfo mcp` as the stdio command and pass the token via the `NOCFO_API_TOKEN` env variable.
+
+## MCP Server (advanced)
+
+Start the MCP server manually from the terminal:
+
+```bash
+nocfo mcp
+```
+
+The server uses stdio transport. Any MCP-compatible client can connect to it.
+
+## CLI Command Groups
+
+| Group               | Description                              |
+| ------------------- | ---------------------------------------- |
+| `auth`              | Configure and verify authentication      |
+| `businesses`        | List and manage businesses               |
+| `accounts`          | Chart of accounts                        |
+| `documents`         | Accounting entries and journal documents |
+| `contacts`          | Customer and supplier contacts           |
+| `invoices`          | Sales invoices                           |
+| `purchase-invoices` | Purchase invoices                        |
+| `products`          | Invoicing products                       |
+| `files`             | File attachments                         |
+| `tags`              | Document tags                            |
+| `user`              | Current user info                        |
+| `mcp`               | Start MCP server                         |
+
+## Development
+
+```bash
+poetry install                # install dependencies
+poetry run pytest             # run tests
+poetry run nocfo --help       # run CLI locally
+```
+
+Regenerate OpenAPI-based command stubs:
+
+```bash
+poetry run python scripts/generate_cli_commands.py
+```
+
+<details>
+<summary>Publishing to PyPI</summary>
+
+```bash
+poetry build
+poetry config pypi-token.pypi <pypi_token>
+poetry publish
+```
+
+For TestPyPI:
+
+```bash
+poetry config repositories.testpypi https://test.pypi.org/legacy/
+poetry config pypi-token.testpypi <testpypi_token>
+poetry publish -r testpypi
+```
+
+</details>
+
+## Security
+
+- Never commit PAT tokens
+- Keep `.env` local only
+- Use separate tokens for test and production
+- Local config contains secrets — do not share
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+

nocfo_cli-0.1.0/README.md

@@ -0,0 +1,251 @@
+<div align="center">
+
+<img src="assets/banner.svg" alt="NoCFO AI Toolkit" width="100%" />
+
+<br />
+
+### Give AI assistants full access to Finnish bookkeeping, invoicing, and business data.
+
+[![PyPI](https://img.shields.io/pypi/v/nocfo-cli?color=%230073E6&label=PyPI)](https://pypi.org/project/nocfo-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/nocfo-cli?color=%230073E6)](https://pypi.org/project/nocfo-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-%230073E6)](LICENSE)
+
+</div>
+
+Open-source Python toolkit that connects [NoCFO](https://nocfo.io) to your terminal and AI workflows — a single package powering a CLI client, an MCP server, and a Cursor AI skill.
+
+## Features
+
+- **All-in-one package** — CLI, MCP server, and Cursor skill from a single `pip install`
+- **60+ MCP tools** across 11 domains (businesses, accounts, invoices, contacts, documents, and more)
+- **OpenAPI-driven** — tools stay in sync with the live NoCFO API schema
+- **PAT authentication** — simple token-based auth with config file, env var, or CLI flag
+- **Dual output** — human-friendly tables for terminals, JSON for scripts and pipelines
+- **Claude Desktop + Cursor** — works as stdio MCP server or standalone CLI
+- **Zero-config run** — `uvx nocfo-cli --help` with no permanent install
+
+## Quick Install
+
+**pip** (recommended)
+
+```bash
+pip install nocfo-cli
+```
+
+**pipx** (isolated install)
+
+```bash
+pipx install nocfo-cli
+```
+
+**uvx** (no install needed)
+
+```bash
+uvx nocfo-cli --help
+```
+
+## Authentication
+
+Create a Personal Access Token at [login.nocfo.io/auth/tokens](https://login.nocfo.io/auth/tokens), then configure once:
+
+```bash
+nocfo auth configure --token <your_pat>
+nocfo auth status
+```
+
+Or pass via environment:
+
+```bash
+export NOCFO_API_TOKEN=<your_pat>
+```
+
+<details>
+<summary>Auth precedence & defaults</summary>
+
+| Priority | Source                            |
+| -------- | --------------------------------- |
+| 1        | `--api-token` CLI flag            |
+| 2        | `NOCFO_API_TOKEN` env var         |
+| 3        | `~/.config/nocfo-cli/config.json` |
+
+Default base URL: `https://api-prd.nocfo.io`
+Default output format: `table`
+
+</details>
+
+## Quick Start
+
+```bash
+nocfo user me                        # current user info
+nocfo businesses list                # list all businesses
+nocfo invoices list --business slug  # sales invoices
+nocfo documents list --business slug --query date_from=2026-01-01
+nocfo contacts create --business slug --field name=Acme
+```
+
+JSON output for automation:
+
+```bash
+nocfo --output json businesses list | jq '.results[]'
+```
+
+## Set Up with Claude Desktop (step-by-step)
+
+Connect NoCFO to Claude so you can ask questions about your bookkeeping in plain language. No coding experience needed.
+
+### 1. Install Python
+
+NoCFO AI Toolkit needs Python 3.10 or newer.
+
+**Mac** — open **Terminal** (search "Terminal" in Spotlight) and run:
+
+```bash
+brew install python
+```
+
+> Don't have Homebrew? Install it first: https://brew.sh
+
+**Windows** — download from https://www.python.org/downloads/ and run the installer. **Check the box** "Add Python to PATH" during install.
+
+Verify it works:
+
+```bash
+python3 --version
+```
+
+You should see `Python 3.10` or higher.
+
+### 2. Get your NoCFO token
+
+You need a Personal Access Token (PAT) so that Claude can read your NoCFO data on your behalf.
+
+1. Open [login.nocfo.io/auth/tokens](https://login.nocfo.io/auth/tokens/) in your browser
+2. **Log in** with your NoCFO account (Apple, Google, Microsoft, or email)
+3. After login, you'll see the **API-avaimet** (API keys) page
+4. Click **Luo uusi avain** ("Create new key")
+5. Give the token a name you'll recognise, e.g. `Claude Desktop`
+6. Click **Luo** ("Create")
+7. The token appears once — **copy it now** and save it somewhere safe (e.g. a password manager). You won't be able to see it again.
+
+> **Tip:** If you lose the token, you can always delete the old one and create a new one from the same page.
+
+### 3. Configure Claude Desktop
+
+1. Open **Claude Desktop**
+2. Go to **Settings → Developer → Edit Config** (or open the file manually — see paths below)
+3. Paste the following into the config file, replacing `your_token_here` with the token from step 2:
+
+```json
+{
+  "mcpServers": {
+    "nocfo": {
+      "command": "uvx",
+      "args": ["nocfo-cli", "mcp"],
+      "env": {
+        "NOCFO_API_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+> If the file already has other servers configured, add the `"nocfo": { ... }` block inside the existing `"mcpServers"` object.
+
+<details>
+<summary>Config file locations</summary>
+
+| OS      | Path                                                              |
+| ------- | ----------------------------------------------------------------- |
+| Mac     | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Windows | `%APPDATA%\Claude\claude_desktop_config.json`                     |
+
+</details>
+
+4. **Restart Claude Desktop**
+
+### 4. Try it out
+
+Open a new chat in Claude and ask:
+
+- _"Listaa yritykseni"_
+- _"Montako myyntilaskua on tällä kuussa?"_
+- _"Ketkä ovat suurimmat asiakkaani?"_
+
+Claude uses NoCFO tools automatically to answer. You'll see a tool icon when it accesses your data.
+
+---
+
+## Set Up with Cursor
+
+Add the same config to Cursor's MCP settings (**Settings → MCP → Add Server**) using `nocfo mcp` as the stdio command and pass the token via the `NOCFO_API_TOKEN` env variable.
+
+## MCP Server (advanced)
+
+Start the MCP server manually from the terminal:
+
+```bash
+nocfo mcp
+```
+
+The server uses stdio transport. Any MCP-compatible client can connect to it.
+
+## CLI Command Groups
+
+| Group               | Description                              |
+| ------------------- | ---------------------------------------- |
+| `auth`              | Configure and verify authentication      |
+| `businesses`        | List and manage businesses               |
+| `accounts`          | Chart of accounts                        |
+| `documents`         | Accounting entries and journal documents |
+| `contacts`          | Customer and supplier contacts           |
+| `invoices`          | Sales invoices                           |
+| `purchase-invoices` | Purchase invoices                        |
+| `products`          | Invoicing products                       |
+| `files`             | File attachments                         |
+| `tags`              | Document tags                            |
+| `user`              | Current user info                        |
+| `mcp`               | Start MCP server                         |
+
+## Development
+
+```bash
+poetry install                # install dependencies
+poetry run pytest             # run tests
+poetry run nocfo --help       # run CLI locally
+```
+
+Regenerate OpenAPI-based command stubs:
+
+```bash
+poetry run python scripts/generate_cli_commands.py
+```
+
+<details>
+<summary>Publishing to PyPI</summary>
+
+```bash
+poetry build
+poetry config pypi-token.pypi <pypi_token>
+poetry publish
+```
+
+For TestPyPI:
+
+```bash
+poetry config repositories.testpypi https://test.pypi.org/legacy/
+poetry config pypi-token.testpypi <testpypi_token>
+poetry publish -r testpypi
+```
+
+</details>
+
+## Security
+
+- Never commit PAT tokens
+- Keep `.env` local only
+- Use separate tokens for test and production
+- Local config contains secrets — do not share
+
+## License
+
+MIT — see [LICENSE](LICENSE).

nocfo_cli-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["poetry-core>=1.9.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry]
+name = "nocfo-cli"
+version = "0.1.0"
+description = "NoCFO CLI, MCP server, and Cursor skill toolkit."
+authors = ["NoCFO"]
+readme = "README.md"
+license = "MIT"
+packages = [
+  { include = "nocfo_toolkit", from = "src" }
+]
+keywords = ["nocfo", "cli", "mcp", "fastmcp", "accounting", "invoicing"]
+
+[tool.poetry.urls]
+Homepage = "https://nocfo.io"
+Documentation = "https://api-prd.nocfo.io/docs"
+
+[tool.poetry.dependencies]
+python = ">=3.10,<4.0"
+fastmcp = ">=2.0"
+httpx = ">=0.27"
+typer = ">=0.12"
+rich = ">=13.0"
+python-dotenv = ">=1.0"
+
+[tool.poetry.group.dev.dependencies]
+pytest = ">=8.0"
+pre-commit = ">=4.0"
+ruff = ">=0.1.7"
+
+[tool.poetry.scripts]
+nocfo = "nocfo_toolkit.cli.app:main"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]

nocfo_cli-0.1.0/src/nocfo_toolkit/__init__.py

@@ -0,0 +1,5 @@
+"""NoCFO AI Toolkit package."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"