English Français العربية

com.pyunto/time-management

Registre officiel IA et agents

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • PYUNTO_TM_API_KEY obligatoire 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que com.pyunto/time-management ?

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

Comment installer com.pyunto/time-management ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour com.pyunto/time-management ?

Oui. Il attend PYUNTO_TM_API_KEY, PYUNTO_TM_PASSWORD, PYUNTO_TM_PASSWORD_FILE, à renseigner dans sa configuration.

com.pyunto/time-management est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient com.pyunto/time-management ?

Il est publié par pyunto. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.