Which integrations are available for this server?

Provides tools for managing TeamViewer accounts, devices, sessions, contacts, groups, policies, monitoring, event logs, connection reports, users, roles, OAuth2 authentication, and more via the TeamViewer Web API.

How do I use TeamViewer MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@TeamViewer MCP Server list my managed devices" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

TeamViewer MCP Server

by NilsTv8

Overview Schema Related Servers Score Discussions

TypeScript

Remote

TeamViewer MCP Server

A Model Context Protocol (MCP) server that exposes the TeamViewer Web API as tools for AI assistants such as Claude.

Features

125 tools across 15 functional groups:

Group	Tools
Account	Get/update/create account, tenant IDs
Company	Get/update company, license info
Device Groups	CRUD, share/unshare
Devices + IoT Sensors	CRUD devices, assign, full IoT sensor management
Contacts	CRUD
Event Logging	Query audit logs by date, type, email, session
Managed Devices	List, update, delete, managers, groups, policy removal
Managed Groups	CRUD, manager management
Monitoring	Alarms, device hardware/software/system info, activation
Policy Management	TeamViewer policies (CRUD), monitoring & patch management policies
Connection Reports	List/get/delete reports, AI summary, chat & voice transcripts, screenshots
Sessions	CRUD service case sessions
User Management	CRUD users, TFA, effective permissions, role assignments
User Roles + User Groups	Full role CRUD, assign/unassign to accounts & groups, user group management
OAuth2	Authorization code flow with PKCE, token refresh, permanent tokens

Related MCP server: paperclip-mcp

Requirements

Node.js 18 or later
A TeamViewer account
An OAuth2 app created in the TeamViewer Developer Portal

Step 1 — Create an OAuth2 App

Before running the server you must register an OAuth2 application in the TeamViewer Developer Portal. This provides the client_id and client_secret the server uses to exchange tokens on your behalf.

Go to login.teamviewer.com/nav#app/myapps and sign in.
Click Create app.
Fill in the required fields:
- Name — any descriptive name (e.g. My MCP Server)
- Description — optional
- Redirect URI — the URI TeamViewer will redirect to after the user authorizes. For local use http://localhost works (you only need to copy the code from the redirect URL — no server required). The authorization page opens as a popup.
- Scopes — select the permissions your app needs (see Available Scopes below).
Click Save. Copy the Client ID and Client Secret — you will need them in the next step.

Step 2 — Install

git clone https://github.com/NilsTv8/TV_MCP_public.git
cd TV_MCP_public
npm install
npm run build

Step 3 — Configure Environment Variables

The server reads credentials from environment variables. Set these in your MCP client configuration (see MCP Client Setup):

Variable	Required	Description
`TEAMVIEWER_CLIENT_ID`	Yes	OAuth2 client ID from the Developer Portal
`TEAMVIEWER_CLIENT_SECRET`	Yes	OAuth2 client secret from the Developer Portal
`TEAMVIEWER_REDIRECT_URI`	Yes	Redirect URI registered in the Developer Portal
`TEAMVIEWER_API_TOKEN`	Optional	Static/permanent API token (bypasses OAuth entirely)

Note: If TEAMVIEWER_API_TOKEN is set, the server uses it directly and skips the OAuth flow. This is the simplest option if you already have a permanent token.

Step 4 — MCP Client Setup

Claude Desktop

Add the following to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "teamviewer": {
      "command": "node",
      "args": ["/absolute/path/to/TV_MCP_public/dist/index.js"],
      "env": {
        "TEAMVIEWER_CLIENT_ID": "your-client-id",
        "TEAMVIEWER_CLIENT_SECRET": "your-client-secret",
        "TEAMVIEWER_REDIRECT_URI": "http://localhost"
      }
    }
  }
}

Restart Claude Desktop after saving.

Claude Code (CLI)

claude mcp add teamviewer \
  -e TEAMVIEWER_CLIENT_ID=your-client-id \
  -e TEAMVIEWER_CLIENT_SECRET=your-client-secret \
  -e TEAMVIEWER_REDIRECT_URI=http://localhost \
  -- node /absolute/path/to/TV_MCP_public/dist/index.js

Other MCP Clients

The server communicates over stdio and is compatible with any MCP-capable client. Pass the three environment variables when spawning the process.

Step 5 — Authenticate

Once the server is connected, run the OAuth flow from within your AI assistant:

1. Get the authorization URL

Call tv_oauth_get_auth_url (optionally pass a scope). The tool returns an authorization_url.

2. Open the URL in your browser

Log in to TeamViewer and click Allow. You will be redirected to your TEAMVIEWER_REDIRECT_URI with a code parameter in the URL, e.g.:

http://localhost/?code=ABC123XYZ&state=...

3. Exchange the code

Call tv_oauth_exchange_code and pass the code value. The access token and refresh token are saved to ~/.teamviewer-mcp/tokens.json (permissions 0600). All subsequent API calls use this token automatically.

Check status at any time with tv_oauth_token_status.

Authentication Reference

Tool	Description
`tv_oauth_get_auth_url`	Generates the authorization URL (PKCE)
`tv_oauth_exchange_code`	Exchanges the auth code for tokens and saves them
`tv_oauth_refresh_token`	Refreshes the access token using the stored refresh token
`tv_oauth_revoke_token`	Revokes the active token and clears local storage
`tv_oauth_create_permanent_token`	Creates a non-expiring permanent API token
`tv_oauth_delete_permanent_token`	Deletes the permanent token
`tv_oauth_token_status`	Shows current authentication state (source, expiry, scopes)
`tv_oauth_clear_tokens`	Clears locally stored tokens (logout)

Available Scopes

Select the scopes your app needs when creating it in the Developer Portal:

Scope	Access
`UserInfo.View`	Read account and user info
`Computers.View`	Read device list
`Computers.Edit`	Modify devices
`SessionCode.Create`	Create service case sessions
`Reports.View`	Read connection reports
`ManagedGroups.View`	Read managed groups
`ManagedGroups.Edit`	Modify managed groups
`UserManagement.View`	Read users
`UserManagement.Edit`	Create and modify users
`EventLogging.View`	Read audit logs

For full access during development you can select all scopes.

Development

# Run in development mode (no build step)
TEAMVIEWER_CLIENT_ID=xxx TEAMVIEWER_CLIENT_SECRET=yyy TEAMVIEWER_REDIRECT_URI=http://localhost npm run dev

# Rebuild after changes
npm run build

Tool Reference

Account Management

Tool	Description
`tv_get_account`	Returns the account associated with the API token
`tv_update_account`	Updates account settings
`tv_create_account`	Creates a new account
`tv_get_tenant_ids`	Retrieves tenant associations

Company

Tool	Description
`tv_get_company`	Returns company details
`tv_update_company`	Updates company information
`tv_get_company_license`	Retrieves licensing data

Device Groups

Tool	Description
`tv_list_device_groups`	Lists groups with optional name filter
`tv_create_device_group`	Creates a new group
`tv_get_device_group`	Returns a group by ID
`tv_update_device_group`	Updates a group
`tv_delete_device_group`	Deletes a group
`tv_share_device_group`	Shares a group with users
`tv_unshare_device_group`	Removes group sharing

Devices

Tool	Description
`tv_list_devices`	Lists devices with optional filtering
`tv_get_device`	Returns a device by ID
`tv_create_device`	Adds a device to the list
`tv_update_device`	Updates device properties
`tv_delete_device`	Removes a device
`tv_assign_device`	Assigns a device to the account
`tv_list_iot_sensors`	Lists IoT sensors on a device
`tv_create_iot_sensor`	Creates a new IoT sensor
`tv_get_iot_sensor`	Returns a sensor by ID
`tv_update_iot_sensor`	Updates sensor settings
`tv_delete_iot_sensor`	Removes a sensor

Contacts

Tool	Description
`tv_list_contacts`	Lists contacts
`tv_get_contact`	Returns a contact by ID
`tv_create_contact`	Sends a contact invite
`tv_delete_contact`	Removes a contact

Event Logging

Tool	Description
`tv_get_event_logs`	Queries audit logs by date range, event type, account email, or session

Managed Devices

Tool	Description
`tv_list_managed_devices`	Lists directly managed devices
`tv_list_company_managed_devices`	Lists company-managed devices
`tv_get_managed_device_assignment_data`	Returns assignment data for onboarding
`tv_get_managed_device`	Returns a managed device by ID
`tv_update_managed_device`	Updates device name, policy, or group
`tv_update_managed_device_description`	Updates device description
`tv_delete_managed_device`	Removes management from a device
`tv_remove_managed_device_policy`	Removes the assigned policy
`tv_get_managed_device_groups`	Lists groups a device belongs to
`tv_update_managed_device_groups`	Edits group membership
`tv_list_managed_device_managers`	Lists managers of a device
`tv_add_managed_device_managers`	Adds managers to a device
`tv_remove_managed_device_manager`	Removes a manager from a device

Managed Groups

Tool	Description
`tv_list_managed_groups`	Lists managed groups
`tv_get_managed_group`	Returns a group by ID
`tv_create_managed_group`	Creates a managed group
`tv_update_managed_group`	Updates a group
`tv_delete_managed_group`	Marks a group as deleted
`tv_list_group_managers`	Lists managers of a group
`tv_add_group_managers`	Adds managers to a group
`tv_update_group_managers`	Updates manager permissions
`tv_remove_group_managers`	Removes managers from a group

Monitoring

Tool	Description
`tv_list_monitoring_alarms`	Lists alarms with optional filters
`tv_list_monitoring_devices`	Lists monitored devices
`tv_activate_monitoring`	Activates monitoring on a device
`tv_get_device_hardware_info`	Returns hardware data (CPU, RAM, disk)
`tv_get_device_system_info`	Returns OS and system information
`tv_get_device_software_info`	Returns installed software

Policy Management

Tool	Description
`tv_list_teamviewer_policies`	Lists TeamViewer configuration policies
`tv_create_teamviewer_policy`	Creates a policy
`tv_get_teamviewer_policy`	Returns a policy by ID
`tv_update_teamviewer_policy`	Updates a policy
`tv_delete_teamviewer_policy`	Deletes a policy
`tv_list_monitoring_policies`	Lists monitoring policies
`tv_get_monitoring_policy`	Returns a monitoring policy by ID
`tv_assign_monitoring_policy`	Assigns monitoring policies to devices/groups
`tv_list_patch_management_policies`	Lists patch management policies
`tv_get_patch_management_policy`	Returns a patch policy by ID
`tv_assign_patch_management_policy`	Assigns patch policies to devices/groups

Connection Reports

Tool	Description
`tv_list_connection_reports`	Lists session reports (max 1000 per call)
`tv_get_connection_report`	Returns a report by ID
`tv_update_connection_report`	Updates report notes
`tv_delete_connection_report`	Deletes a report
`tv_get_connection_ai_summary`	Returns AI-generated session summary
`tv_get_connection_chat_transcript`	Returns chat transcript
`tv_get_connection_voice_transcript`	Returns voice call transcript
`tv_list_connection_screenshots`	Lists available screenshots
`tv_get_connection_screenshot`	Downloads a specific screenshot
`tv_list_device_reports`	Lists device reports

Sessions

Tool	Description
`tv_list_sessions`	Lists service case sessions
`tv_get_session`	Returns a session by code
`tv_create_session`	Creates a service case session
`tv_update_session`	Updates a session
`tv_delete_session`	Closes a session

User Management

Tool	Description
`tv_list_users`	Lists users with optional filtering
`tv_create_user`	Creates a user
`tv_get_user`	Returns a user by ID
`tv_update_user`	Updates user properties
`tv_delete_user`	Deletes a user
`tv_deactivate_user_tfa`	Deactivates two-factor authentication
`tv_get_user_effective_permissions`	Returns consolidated permissions
`tv_get_user_roles`	Returns roles assigned to a user
`tv_respond_to_join_company_request`	Approves or rejects a join request

User Roles

Tool	Description
`tv_list_user_roles`	Lists all user roles
`tv_create_user_role`	Creates a role with permissions
`tv_update_user_role`	Updates a role
`tv_delete_user_role`	Deletes a role
`tv_get_user_role_permissions`	Returns available permission definitions
`tv_get_predefined_user_role`	Returns the predefined default role
`tv_set_predefined_user_role`	Sets a role as the default
`tv_clear_predefined_user_role`	Clears the default role
`tv_assign_user_role_to_accounts`	Assigns a role to user accounts
`tv_assign_user_role_to_usergroup`	Assigns a role to a user group
`tv_unassign_user_role_from_accounts`	Removes a role from user accounts
`tv_unassign_user_role_from_usergroup`	Removes a role from a user group
`tv_get_user_role_account_assignments`	Lists accounts assigned to a role
`tv_get_user_role_group_assignments`	Lists groups assigned to a role

User Groups

Tool	Description
`tv_list_user_groups`	Lists all user groups
`tv_create_user_group`	Creates a user group
`tv_get_user_group`	Returns a group by ID
`tv_update_user_group`	Updates a group name
`tv_delete_user_group`	Removes a group
`tv_list_user_group_members`	Lists group members
`tv_add_user_group_members`	Adds users to a group
`tv_remove_user_group_members`	Removes users from a group
`tv_remove_user_group_member`	Removes a single user from a group
`tv_get_user_group_role`	Returns the role assigned to a group

License

MIT

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

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/NilsTv8/TV_ONE_MCP_Anthropic_noDCR'

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