English Français العربية

com.pyunto/time-management

Official registry AI and agents

Read your Pyunto Time Management schedule and log time from an AI assistant. E2EE project planning.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @pyunto/tm-mcp
Claude Code 
claude mcp add time-management -e 'PYUNTO_TM_API_KEY=<your pyunto_tm_api_key>' -e 'PYUNTO_TM_BASE_URL=https://tm.pyunto.com' -e 'PYUNTO_TM_PASSWORD=<your pyunto_tm_password>' -e 'PYUNTO_TM_PASSWORD_FILE=<your pyunto_tm_password_file>' -- npx -y @pyunto/tm-mcp@0.3.6
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "time-management": {
            "command": "npx",
            "args": [
                "-y",
                "@pyunto/tm-mcp@0.3.6"
            ],
            "env": {
                "PYUNTO_TM_API_KEY": "<your pyunto_tm_api_key>",
                "PYUNTO_TM_BASE_URL": "https://tm.pyunto.com",
                "PYUNTO_TM_PASSWORD": "<your pyunto_tm_password>",
                "PYUNTO_TM_PASSWORD_FILE": "<your pyunto_tm_password_file>"
            }
        }
    }
}

Environment variables

  • PYUNTO_TM_API_KEY required secret API key (ptm_...) minted in Settings → Account → API keys. Required to read or write data; listing the tools works without it.
  • PYUNTO_TM_BASE_URL Base URL, for self-hosted instances
  • PYUNTO_TM_PASSWORD secret Account password; unwraps the private key locally so E2EE project and task names decrypt
  • PYUNTO_TM_PASSWORD_FILE secret Path to a file holding the account password, instead of PYUNTO_TM_PASSWORD

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Pyunto Time Management — integrations
  2. Why this part is public
  3. Quick start (MCP)
  4. Quick start (SDK)
  5. Development
  6. Security
  7. Licence

Pyunto Time Management — integrations

Open-source client libraries for Pyunto Time Management, a time-management and project-planning service with end-to-end encryption.

PackageWhat it is
@pyunto/tm-sdkTypeScript client for the public REST API (v1), with client-side E2EE decryption
@pyunto/tm-mcpMCP (Model Context Protocol) server — connects Claude Code, Claude Desktop, Codex CLI, Cursor and other AI clients to an account

The service itself is not open source. This repository contains only the client side: HTTP calls against the documented public API, plus the crypto needed to decrypt your own data locally. There is nothing here that talks to the database, handles billing, or holds a key.

Why this part is public

The MCP server can be given your account password so it can decrypt project and task names. That is a lot to ask of a program you cannot read, so this is the part we publish: you can verify for yourself that the password is used only to unwrap the private key in your own process, and is never transmitted.

See sdk/src/crypto.ts for the primitives and mcp/src/index.ts for how they're used.

Quick start (MCP)

No clone needed — the published package runs straight from npm:

claude mcp add pyunto-tm \
  --env PYUNTO_TM_API_KEY=ptm_your_key \
  -- npx -y @pyunto/tm-mcp

Full setup instructions, including Claude Desktop, Codex CLI and Cursor: https://tm.pyunto.com/docs/mcp.en.md (日本語: https://tm.pyunto.com/docs/mcp.ja.md).

Get an API key from Settings → Account → API keys in the app. Scopes decide what an integration may read or write, and a key can be revoked at any time.

Quick start (SDK)

npm install @pyunto/tm-sdk
import { PyuntoTM } from "@pyunto/tm-sdk";

const tm = new PyuntoTM({ apiKey: process.env.PTM_KEY! });

// Dates, durations and aggregates need no key material at all
const record = await tm.serviceRecord("2026-08-01", "2026-08-31");

// Names and memos are encrypted; unlock decrypts them locally
await tm.unlock(process.env.PTM_PASSWORD!);
const projects = await tm.projects({ decrypt: true });

Development

npm workspaces; Node 18+.

npm install
npm run build     # both packages
npm test          # sdk crypto round-trips + mcp tools against a stub API

mcp depends on @pyunto/tm-sdk by version, so the published package resolves it from the registry while local development links the workspace copy.

Security

Found a problem in this code, or in the service? Please report it privately rather than opening a public issue: support@pyunto.com.

Licence

MIT — see LICENSE.

Frequently asked questions

What is com.pyunto/time-management?

Read your Pyunto Time Management schedule and log time from an AI assistant. E2EE project planning.

How do I install com.pyunto/time-management?

It runs on your machine. In Claude Code: claude mcp add time-management -e 'PYUNTO_TM_API_KEY=<your pyunto_tm_api_key>' -e 'PYUNTO_TM_BASE_URL=https://tm.pyunto.com' -e 'PYUNTO_TM_PASSWORD=<your pyunto_tm_password>' -e 'PYUNTO_TM_PASSWORD_FILE=<your pyunto_tm_password_file>' -- npx -y @pyunto/tm-mcp@0.3.6. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.pyunto/time-management need an API key?

Yes. It expects PYUNTO_TM_API_KEY, PYUNTO_TM_PASSWORD, PYUNTO_TM_PASSWORD_FILE, which you set in its configuration.

Is com.pyunto/time-management open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains com.pyunto/time-management?

It is published by pyunto. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.