Automated Workflows & Organization
Use the KlickTipp MCP Server with Claude Code or Codex
Use this guide to connect Claude Code or Codex to your KlickTipp account through the local KlickTipp MCP Server.
Once connected, your AI coding assistant can inspect KlickTipp structures, use tools provided by the KlickTipp Management API, and help you manage your contacts.
Are you using Claude Desktop instead of Claude Code? Follow the guide: Set Up the KlickTipp MCP Server with Claude Desktop.
Set Up the KlickTipp MCP Server
Prerequisites
- Access to a KlickTipp account with a username and password
- Claude Code or a locally installed Codex client
You do not need to check every technical requirement before installation. Claude Code or Codex can read the KlickTipp MCP Server repository and verify the current requirements for your system.
Recommended Secure Setup
- Install the ready-made KlickTipp MCP Server.
- Let Claude Code or Codex check the repository requirements.
- Connect the MCP Server to your KlickTipp account.
- Test the connection using read-only access.
- Enable write tools only when you explicitly need them.
Install the KlickTipp MCP Server
Open a new chat in Claude Code or Codex to install the KlickTipp MCP Server.
Paste the following prompt:
Please set up the KlickTipp MCP Server from:
https://github.com/klicktipp/klicktipp-mcp
Use the repository README, package.json and .env.example as the source of truth.
Check my system requirements first. If anything is missing, guide me through the smallest safe fix.
Then clone the repository, install dependencies, create .env from .env.example, and help me fill in the required values locally.
Use username and password authentication for this local setup.
Keep the server read-only:
KT_TOOL_MODE=readonly
KT_ENABLE_WRITES=false
KT_ENABLE_DESTRUCTIVE=false
Do not ask me to paste credentials into chat.
Test read-only tools first.
Kopieren
Approve only the actions required to clone the repository, install dependencies, create the local .env file, and run read-only tests. Do not approve publishing, committing changes, deleting files, or enabling write tools during setup.
Connect the MCP Server to KlickTipp
The .env file is your local configuration file. The KlickTipp MCP Server reads your KlickTipp username and password from this file. For security, open the file yourself and enter your credentials manually outside the AI chat.
- Open the generated .env file in your local editor. Do not ask Claude Code or Codex to open or display it after you have added your credentials.
Show me the path to the generated .env file. Do not display the file contents.
Kopieren
- Do not replace the entire file. Enter your username and password directly into the local .env file. Do not paste your KlickTipp credentials into the chat.
KT_AUTH_MODE=session
KT_USERNAME=your-klicktipp-username
KT_PASSWORD=your-klicktipp-password
Kopieren
- Save your changes to the .env file.
Keep the .env file local and do not commit it to Git.
Test the Connection
After configuring the connection, restart Claude Code or Codex and open a new chat.
Test the connection with the following example prompts:
List my KlickTipp tags.
Kopieren
List my KlickTipp fields.
Kopieren
List my KlickTipp opt-in processes.
Kopieren
If any of these read-only tests fail, fix the configuration before enabling write tools.
Enable Write Tools
Enable write tools only after the read-only tools work reliably. Write tools can change data in your KlickTipp account. Keep destructive tools disabled.
Update the following settings in the .env file and save your changes:
KT_TOOL_MODE=full
KT_ENABLE_WRITES=true
KT_ENABLE_DESTRUCTIVE=false
Kopieren
Restart Claude Code or Codex after changing the .env file.
Troubleshoot the MCP Connection
If Claude Code or Codex cannot start the KlickTipp MCP Server, use the following prompt:
Please inspect the MCP Server logs, verify node -v and npm -v, check the .env file, and confirm that the MCP client points to the correct absolute path.
Kopieren
If authentication fails, check the following:
- Is KT_AUTH_MODE=session set in the .env file?
- Is KT_USERNAME correct?
- Is KT_PASSWORD correct?
- Can you log in to KlickTipp normally with the same username and password?
- Is the .env file located in the KlickTipp MCP Server repository folder?
KlickTipp MCP Server FAQs
What Is the KlickTipp MCP Server?
The KlickTipp MCP Server connects Claude Code or a locally installed Codex client to your KlickTipp account. It allows your AI coding assistant to read selected KlickTipp structures and data and, after you explicitly enable them, use write tools.
Does the KlickTipp MCP Server Run Locally?
Yes. The KlickTipp MCP Server is installed and runs locally on your computer. Its configuration and your KlickTipp credentials are stored in a local .env file.
Can I Connect KlickTipp to Claude Code or Codex?
Yes. You can connect Claude Code or a locally installed Codex client to your KlickTipp account through the KlickTipp MCP Server. A separate guide is available for Claude Desktop.
Do I Need to Enter My KlickTipp Credentials in the AI Chat?
No. Never enter your KlickTipp username or password in the AI chat. Add your credentials manually to the local .env file and do not ask Claude Code or Codex to open or display the file afterward.
Can Claude Code or Codex Change Data in My KlickTipp Account?
Only after you enable write tools. Start with read-only access and activate write tools only after the connection and all read-only tests work reliably. Keep destructive tools disabled.
What Can I Do If the KlickTipp MCP Server Connection Does Not Work?
Check whether the required components are installed, the .env file is located in the correct repository folder, and your credentials are correct. Also verify the MCP Server configuration and confirm that you can log in to KlickTipp normally with the same credentials.
Partner Authentication for Multiple Accounts
For multi-account integrations, production use, or customer account management, do not use username and password authentication. Use Developer Key and Customer Key authentication instead: Management API Authentication.
Additional Guides and Resources
Set Up the KlickTipp MCP Server with Claude Desktop
Use this guide if you want to connect the KlickTipp MCP Server to Claude Desktop instead of Claude Code or Codex.
KlickTipp AI Agent for Voice and Chat Control
Explore additional ways to manage KlickTipp contacts with AI and the KlickTipp Management API.
KlickTipp Integrations and API
Discover more ways to connect KlickTipp with external applications and services.