en es ja ko zh

FreeAgent MCP Server

Name: FreeAgent MCP Server
Author: markpitt

by markpitt

Overview Schema Related Servers Score Discussions

JavaScript

Remote

Servidor MCP de FreeAgent

Un servidor MCP (Protocolo de Contexto de Modelo) de Claude para gestionar los registros de tiempo y los temporizadores de FreeAgent. Este servidor permite a Claude interactuar con su cuenta de FreeAgent para registrar el tiempo, administrar los temporizadores y gestionar las operaciones de registro de tiempo.

Licencia: MIT

Características

Listar y filtrar hojas de tiempo con datos anidados
Crear nuevos timeslips
Actualizar los registros de tiempo existentes
Temporizadores de inicio y parada
Eliminar resbalones de tiempo
Actualización automática del token OAuth
Manejo integral de errores
Compatibilidad con Docker

Related MCP server: Beebole MCP

Prerrequisitos

Node.js 18+ (para uso directo de Node.js)
Docker y Docker Compose (para uso en contenedores)
Una cuenta FreeAgent con acceso a la API
Credenciales de OAuth desde el panel de desarrolladores de FreeAgent

Instalación

Opción 1: Instalación directa de Node.js

Clonar el repositorio:

git clone https://github.com/yourusername/freeagent-mcp.git
cd freeagent-mcp

Instalar dependencias:

npm install

Obtenga sus tokens OAuth:

# Set your FreeAgent credentials
export FREEAGENT_CLIENT_ID="your_client_id"
export FREEAGENT_CLIENT_SECRET="your_client_secret"

# Run the OAuth setup script
node scripts/get-oauth-tokens.js

Opción 2: Instalación de Docker

Clonar el repositorio:

git clone https://github.com/yourusername/freeagent-mcp.git
cd freeagent-mcp

Crea tu archivo de entorno:

cp .env.example .env
# Edit .env with your FreeAgent credentials

Construir imagen de Docker:

docker build -t freeagent-mcp .

Configuración

Agregue el servidor a su configuración de MCP (normalmente en %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json ):

Para la instalación de Node.js:

{
  "mcpServers": {
    "freeagent": {
      "command": "node",
      "args": ["path/to/freeagent-mcp/build/index.js"],
      "env": {
        "FREEAGENT_CLIENT_ID": "your_client_id",
        "FREEAGENT_CLIENT_SECRET": "your_client_secret",
        "FREEAGENT_ACCESS_TOKEN": "your_access_token",
        "FREEAGENT_REFRESH_TOKEN": "your_refresh_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Para la instalación de Docker:

{
  "mcpServers": {
    "freeagent": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "FREEAGENT_CLIENT_ID",
        "-e", "FREEAGENT_CLIENT_SECRET",
        "-e", "FREEAGENT_ACCESS_TOKEN",
        "-e", "FREEAGENT_REFRESH_TOKEN",
        "freeagent-mcp"
      ],
      "env": {
        "FREEAGENT_CLIENT_ID": "your_client_id",
        "FREEAGENT_CLIENT_SECRET": "your_client_secret",
        "FREEAGENT_ACCESS_TOKEN": "your_access_token",
        "FREEAGENT_REFRESH_TOKEN": "your_refresh_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Uso

Una vez configurado, Claude puede utilizar las siguientes herramientas:

Lista de resbalones de tiempo

{
  "from_date": "2024-01-01",      // Start date (YYYY-MM-DD)
  "to_date": "2024-03-04",        // End date (YYYY-MM-DD)
  "updated_since": "2024-03-04T12:00:00Z",  // ISO datetime
  "view": "all",                  // "all", "unbilled", or "running"
  "user": "https://api.freeagent.com/v2/users/123",
  "task": "https://api.freeagent.com/v2/tasks/456",
  "project": "https://api.freeagent.com/v2/projects/789",
  "nested": true                  // Include nested resources
}

Crear Timeslip

{
  "task": "https://api.freeagent.com/v2/tasks/123",
  "user": "https://api.freeagent.com/v2/users/456",
  "project": "https://api.freeagent.com/v2/projects/789",
  "dated_on": "2024-03-04",
  "hours": "1.5",
  "comment": "Optional comment"
}

Controles del temporizador

// Start timer
{
  "id": "123"
}

// Stop timer
{
  "id": "123"
}

Desarrollo

Desarrollo con Node.js

# Build the project
npm run build

# Watch for changes
npm run watch

# Run tests (when implemented)
npm test

Desarrollo de Docker

# Build the Docker image
docker build -t freeagent-mcp .

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -am 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

FreeAgent por su excelente documentación API
El equipo de Claude para el SDK de MCP

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

timely-mcp-server
Project Management Workplace & Productivity
rollecode
F
license
Not graded
quality
B
maintenance
MCP server for Timely time tracking API. Connects Claude Code to your Timely account for reading and creating time entries, projects, tasks, and users.
Updated 3 months ago (2026-05-22 15:09 UTC)
4
Beebole MCP
Project Management Workplace & Productivity
NeoNexAI
A
license
A
quality
A
maintenance
MCP server to connect Claude with Beebole for time tracking, enabling project and task listing, time entry retrieval, and time logging.
Updated 2 months ago (2026-07-04 13:12 UTC)
27
14
MIT
Work-Timer
Project Management Finance
JoelBondoux
A
license
Not graded
quality
D
maintenance
An MCP server for time tracking and billing that allows freelancers to control timers, manage projects, and export invoices via natural language in any MCP-compatible AI assistant.
Updated 4 days ago (2026-08-24 06:14 UTC)
6
MIT
freshbooks-mcp-server
Finance Project Management
bitovi
F
license
Not graded
quality
A
maintenance
An MCP server that connects Claude to FreshBooks, enabling reading and management of invoices, clients, expenses, projects, and time entries via natural language.
Updated 9 days ago (2026-08-18 20:36 UTC)
1

View all related MCP servers

Related MCP Connectors

agentcentral
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
mcp
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Remote Desktop Commander
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/markpitt/freeagent-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server