Freematica

# Install the MCP server `io.github.nubiia-dev/mcp-freematica`

Its page: https://plug.directory/servers/io.github.nubiia-dev/mcp-freematica

It runs on the person's machine and needs Node.js installed.

Ask the person for `YOUR_FREEMATICA_AUTH_TOKEN`, `YOUR_FREEMATICA_AUTH_COMPANY`, `YOUR_FREEMATICA_AUTH_ORGANIZATION`, `YOUR_FREEMATICA_AUTH_APP`, `YOUR_FREEMATICA_AUTH_SESSION` and put it in place of the placeholder; never invent a value.

Use the section for the person's client.

## Claude Desktop, Cursor, Devin Desktop, Cline, LM Studio, Gemini CLI, mcp-client-cli, oterm, TUUI, BoltAI, AnythingLLM, Augment Code, Bob Shell, ECA, Kiro, Kiro CLI

Merge into the place for the person's client:

- Claude Desktop: claude_desktop_config.json (Settings › Developer › Edit Config)
- Cursor: ~/.cursor/mcp.json
- Devin Desktop: ~/.config/devin/mcp_config.json
- Cline: cline_mcp_settings.json (MCP Servers › Configure › Configure MCP Servers)
- LM Studio: mcp.json (Program › Install › Edit mcp.json)
- Gemini CLI: ~/.gemini/settings.json
- mcp-client-cli: ~/.llm/config.json
- oterm: config.json in oterm's data folder (~/Library/Application Support/oterm on macOS, ~/.local/share/oterm on Linux, %APPDATA%\oterm on Windows)
- TUUI: resources/assets/config/mcp.json in the installed app
- BoltAI: ~/.boltai/mcp.json
- AnythingLLM: anythingllm_mcp_servers.json in the AnythingLLM storage plugins directory
- Augment Code: Augment Settings Panel – MCP section – Import from JSON (VS Code extension)
- Bob Shell: ~/.bob/settings/mcp.json (global) or .bob/mcp.json (project)
- ECA: ~/.config/eca/config.json (global) or .eca/config.json in the project
- Kiro: ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace)
- Kiro CLI: ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace)

```json
{
  "mcpServers": {
    "mcp-freematica": {
      "command": "npx",
      "args": ["-y", "@nubiia/mcp-freematica@0.11.2"],
      "env": { "FREEMATICA_AUTH_TOKEN": "YOUR_FREEMATICA_AUTH_TOKEN", "FREEMATICA_AUTH_COMPANY": "YOUR_FREEMATICA_AUTH_COMPANY", "FREEMATICA_AUTH_ORGANIZATION": "YOUR_FREEMATICA_AUTH_ORGANIZATION", "FREEMATICA_AUTH_APP": "YOUR_FREEMATICA_AUTH_APP", "FREEMATICA_AUTH_SESSION": "YOUR_FREEMATICA_AUTH_SESSION" }
    }
  }
}
```

## Claude Code

Run in a terminal:

```sh
claude mcp add --env FREEMATICA_AUTH_TOKEN=YOUR_FREEMATICA_AUTH_TOKEN --env FREEMATICA_AUTH_COMPANY=YOUR_FREEMATICA_AUTH_COMPANY --env FREEMATICA_AUTH_ORGANIZATION=YOUR_FREEMATICA_AUTH_ORGANIZATION --env FREEMATICA_AUTH_APP=YOUR_FREEMATICA_AUTH_APP --env FREEMATICA_AUTH_SESSION=YOUR_FREEMATICA_AUTH_SESSION --transport stdio mcp-freematica -- npx -y @nubiia/mcp-freematica@0.11.2
```

## VS Code

Merge into .vscode/mcp.json:

```json
{
  "servers": {
    "mcp-freematica": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@nubiia/mcp-freematica@0.11.2"],
      "env": { "FREEMATICA_AUTH_TOKEN": "YOUR_FREEMATICA_AUTH_TOKEN", "FREEMATICA_AUTH_COMPANY": "YOUR_FREEMATICA_AUTH_COMPANY", "FREEMATICA_AUTH_ORGANIZATION": "YOUR_FREEMATICA_AUTH_ORGANIZATION", "FREEMATICA_AUTH_APP": "YOUR_FREEMATICA_AUTH_APP", "FREEMATICA_AUTH_SESSION": "YOUR_FREEMATICA_AUTH_SESSION" }
    }
  }
}
```

## Zed

Merge into ~/.config/zed/settings.json:

```json
{
  "context_servers": {
    "mcp-freematica": {
      "command": "npx",
      "args": ["-y", "@nubiia/mcp-freematica@0.11.2"],
      "env": { "FREEMATICA_AUTH_TOKEN": "YOUR_FREEMATICA_AUTH_TOKEN", "FREEMATICA_AUTH_COMPANY": "YOUR_FREEMATICA_AUTH_COMPANY", "FREEMATICA_AUTH_ORGANIZATION": "YOUR_FREEMATICA_AUTH_ORGANIZATION", "FREEMATICA_AUTH_APP": "YOUR_FREEMATICA_AUTH_APP", "FREEMATICA_AUTH_SESSION": "YOUR_FREEMATICA_AUTH_SESSION" }
    }
  }
}
```

## Continue

Merge into ~/.continue/config.yaml:

```yaml
mcpServers:
  - name: "mcp-freematica"
    type: stdio
    command: "npx"
    args:
      - "-y"
      - "@nubiia/mcp-freematica@0.11.2"
    env:
      "FREEMATICA_AUTH_TOKEN": "YOUR_FREEMATICA_AUTH_TOKEN"
      "FREEMATICA_AUTH_COMPANY": "YOUR_FREEMATICA_AUTH_COMPANY"
      "FREEMATICA_AUTH_ORGANIZATION": "YOUR_FREEMATICA_AUTH_ORGANIZATION"
      "FREEMATICA_AUTH_APP": "YOUR_FREEMATICA_AUTH_APP"
      "FREEMATICA_AUTH_SESSION": "YOUR_FREEMATICA_AUTH_SESSION"
```

## Goose

Merge into ~/.config/goose/config.yaml:

```yaml
extensions:
  "mcp-freematica":
    type: stdio
    name: "mcp-freematica"
    enabled: true
    cmd: "npx"
    args: ["-y", "@nubiia/mcp-freematica@0.11.2"]
    env_keys: []
    envs: { "FREEMATICA_AUTH_TOKEN": "YOUR_FREEMATICA_AUTH_TOKEN", "FREEMATICA_AUTH_COMPANY": "YOUR_FREEMATICA_AUTH_COMPANY", "FREEMATICA_AUTH_ORGANIZATION": "YOUR_FREEMATICA_AUTH_ORGANIZATION", "FREEMATICA_AUTH_APP": "YOUR_FREEMATICA_AUTH_APP", "FREEMATICA_AUTH_SESSION": "YOUR_FREEMATICA_AUTH_SESSION" }
    timeout: 300
```

## Codex

Run in a terminal:

```sh
codex mcp add mcp-freematica --env FREEMATICA_AUTH_TOKEN=YOUR_FREEMATICA_AUTH_TOKEN --env FREEMATICA_AUTH_COMPANY=YOUR_FREEMATICA_AUTH_COMPANY --env FREEMATICA_AUTH_ORGANIZATION=YOUR_FREEMATICA_AUTH_ORGANIZATION --env FREEMATICA_AUTH_APP=YOUR_FREEMATICA_AUTH_APP --env FREEMATICA_AUTH_SESSION=YOUR_FREEMATICA_AUTH_SESSION -- npx -y @nubiia/mcp-freematica@0.11.2
```

## Agenvoy

Merge into ~/.config/agenvoy/mcp.json:

```json
{
  "servers": {
    "mcp-freematica": {
      "command": "npx",
      "args": ["-y", "@nubiia/mcp-freematica@0.11.2"],
      "env": { "FREEMATICA_AUTH_TOKEN": "YOUR_FREEMATICA_AUTH_TOKEN", "FREEMATICA_AUTH_COMPANY": "YOUR_FREEMATICA_AUTH_COMPANY", "FREEMATICA_AUTH_ORGANIZATION": "YOUR_FREEMATICA_AUTH_ORGANIZATION", "FREEMATICA_AUTH_APP": "YOUR_FREEMATICA_AUTH_APP", "FREEMATICA_AUTH_SESSION": "YOUR_FREEMATICA_AUTH_SESSION" }
    }
  }
}
```

## Amp

Merge into ~/.config/amp/settings.json (user) or .amp/settings.json (workspace):

```json
{
  "amp.mcpServers": {
    "mcp-freematica": {
      "command": "npx",
      "args": ["-y", "@nubiia/mcp-freematica@0.11.2"],
      "env": { "FREEMATICA_AUTH_TOKEN": "YOUR_FREEMATICA_AUTH_TOKEN", "FREEMATICA_AUTH_COMPANY": "YOUR_FREEMATICA_AUTH_COMPANY", "FREEMATICA_AUTH_ORGANIZATION": "YOUR_FREEMATICA_AUTH_ORGANIZATION", "FREEMATICA_AUTH_APP": "YOUR_FREEMATICA_AUTH_APP", "FREEMATICA_AUTH_SESSION": "YOUR_FREEMATICA_AUTH_SESSION" }
    }
  }
}
```

Then restart the client, or reload its MCP servers, and ask it to list the server's tools to confirm it started.